@jennie-shawn/starwork 0.1.0-alpha.2 → 0.1.0-alpha.21

package/README.md

@@ -1,153 +1,165 @@
 # StarWork
 
-StarWork is an AI workspace protocol and toolkit for keeping long-running work organized across agents, projects, and sessions.
+StarWork 是给 AI 协作准备的项目工作台。
 
-It provides:
+它帮你把一个普通项目目录整理成 AI 能长期理解和接手的工作环境：项目是什么、现在在做什么、哪些文件能改、重要资料在哪里、上一个 AI 会话交接了什么，都有固定位置可读。
 
-- **Core**: workspace structures, roles, health checks, and project-state conventions.
-- **CLI**: commands for creating, checking, adapting, extending, and spawning workspaces.
-- **Packs**: scenario templates for common workflows.
-- **Skills**: Agent workflows that help Codex and other agents design StarWork workspaces.
+如果你经常遇到这些情况，StarWork 就是为你准备的：
 
-StarWork is currently in early A-test. The current package is intended for installation testing, workflow validation, and product feedback.
+- 每次打开 AI，都要重新解释项目背景。
+- 换一个 AI 会话后，上下文又断了。
+- 项目资料、草稿、最终版本混在一起，AI 也分不清。
+- 想让多个 AI 分工协作，但不知道谁负责什么。
+- 项目做久了，重要判断、经验和交接记录散落在聊天里。
 
-## Install
+StarWork 做的事情很简单：把项目变成一个 AI 看得懂、你也放心的工作台。
 
-Install the CLI globally:
+## StarWork 能帮你做什么
 
-```bash
-npm install -g @jennie-shawn/starwork
-starwork --help
-```
+### 让 AI 先读懂项目
 
-Or run it without global installation:
+StarWork 会给项目补上清晰的项目说明、当前任务、协作规则和健康检查入口。AI 进入项目时，不需要从零猜上下文。
 
-```bash
-npx @jennie-shawn/starwork --help
-```
+### 保护你的项目文件
 
-## Install Skills
+第一次接入项目时，StarWork 会先预览将要写入的协作文件，不会直接改业务代码，也不会直接覆盖已有 AI 规则文件。
 
-StarWork skills are distributed through the `skills` CLI from the GitHub repository.
+### 留住长期知识
 
-Install all StarWork skills for Codex:
+你可以开启项目知识库，把客户背景、产品规则、术语解释、长期策略和复盘结论沉淀下来。原始资料仍放在资料区，临时草稿仍放在草稿区。
 
-```bash
-npx skills add jennie-shawn/starwork --skill '*' -g -a codex -y
-```
+### 支持多个 AI 分工
 
-Install individual skills:
+你可以给一个项目创建产品规划、开发、验收、资料整理等不同 Agent。StarWork 会记录每个 Agent 的职责、可写范围、共享输出和交接状态。
 
-```bash
-npx skills add jennie-shawn/starwork --skill starworkInit -g -a codex -y
-npx skills add jennie-shawn/starwork --skill starworkSpawn -g -a codex -y
-```
+### 管理多个项目
 
-Available skills:
+如果你有很多项目，可以建立一个项目中心，再从项目中心创建新的项目工作台，统一登记和巡检。
 
-- `starworkInit`: helps an agent design a friendly `starwork init` plan for a new workspace.
-- `starworkSpawn`: helps an agent design a `starwork spawn --blueprint` plan for a satellite workspace.
+## 它不是什么
 
-## Quick Start
+StarWork 不是另一个笔记软件，也不是自动替你写完整项目的黑盒。
 
-Create a single-project workspace:
+它更像一套项目协作底座：帮 AI 找到正确上下文，帮你保留规则、边界、任务、知识和交接记录。
 
-```bash
-starwork init \
-  --type single-matter \
-  --pack general \
-  --name "StarWork A Test" \
-  --target ~/Desktop/starwork-a-test \
-  --yes
-```
+## 第一次使用
 
-Check the workspace:
+最推荐的方式：让你的 AI 助手带你完成。
 
-```bash
-starwork doctor --target ~/Desktop/starwork-a-test
+把下面这段话发给 Codex、Claude Code、Cursor 或你正在使用的 AI 工具：
+
+```text
+请用 `starwork` 主入口帮我开始使用 StarWork。
+
+请先阅读 StarWork 引导文档，理解 StarWork 是什么：
+https://raw.githubusercontent.com/jennie-shawn/StarWork/main/README.md
+
+如果本机还没有安装 StarWork CLI 或 Skills，请先按这份 Agent 安装指南完成安装：
+https://raw.githubusercontent.com/jennie-shawn/StarWork/main/docs/agent-install-guide.md
+
+请先说明 StarWork 是什么、能帮我做什么、接下来我应该走哪个能力。
+然后先预览将要写入的文件，不要直接写入。
+等我确认后，再正式初始化并运行健康检查。
 ```
 
-Create a multi-project Hub:
+如果你想自己在终端试用，也可以先用 `npx` 预览，不需要全局安装：
 
 ```bash
-starwork init \
-  --type hub \
-  --name "StarWork Hub A Test" \
-  --target ~/Desktop/starwork-hub-a-test \
-  --yes
+npx @jennie-shawn/starwork init \
+  --type project \
+  --pack general \
+  --language zh \
+  --target ~/Desktop/my-starwork-project \
+  --dry-run
 ```
 
-Spawn a project from the Hub:
+确认预览没问题后再写入：
 
 ```bash
-starwork spawn \
-  --hub ~/Desktop/starwork-hub-a-test \
-  --name "Alpha Project" \
-  --target ~/Desktop/starwork-alpha-project \
-  --mode matter \
+npx @jennie-shawn/starwork init \
+  --type project \
+  --pack general \
+  --language zh \
+  --target ~/Desktop/my-starwork-project \
   --yes
 ```
 
-Check the spawned project:
+最后检查工作台：
 
 ```bash
-starwork doctor --target ~/Desktop/starwork-alpha-project
+npx @jennie-shawn/starwork doctor --target ~/Desktop/my-starwork-project
 ```
 
-## CLI Commands
+## 三种常见用法
 
-```text
-starwork init
-starwork doctor
-starwork spawn
-starwork adapt
-starwork pack install
-```
+### 我只是想试试
 
-Current capabilities:
+创建一个新的空项目工作台。StarWork 会生成一套推荐结构，你可以安全体验。
 
-- `init`: creates a local starter workspace, local matter workspace, or multi-project Hub.
-- `doctor`: checks workspace health, required files, Pack installation, and blueprint customization.
-- `spawn`: creates and registers a satellite project from an existing Hub.
-- `adapt`: generates Agent-specific adapter files for Claude Code, Cursor, and related tools.
-- `pack install`: installs supported Packs into compatible workspaces.
+### 我已经有一个真实项目
 
-## Repository Structure
+把现有项目接入 StarWork。它会保留已有文件，先预览要补充的协作结构；如果项目里已经有 AI 规则文件，会先生成待整合草稿，不直接覆盖。
 
-```text
-.
-├── core/       # StarWork Core protocol, kits, profiles, and presets
-├── cli/        # CLI implementation and command specifications
-├── packs/      # Scenario Packs
-├── skills/     # Agent skills
-├── schemas/    # Structured schemas
-├── adapters/   # Agent adapter rules
-├── examples/   # Examples and sample snippets
-└── docs/       # Product documentation and A-test guides
-```
+### 我有很多项目
 
-## A-test Notes
+创建项目中心。项目中心用来登记多个项目，再为每个项目创建自己的工作台。
 
-This release is intended for early testers. Please focus feedback on:
+## 你还可以开启的功能
 
-- whether the CLI installs and runs cleanly;
-- whether generated workspace structures are easy to understand;
-- whether `doctor` explains problems clearly;
-- whether Hub + Satellite workflows feel natural;
-- whether `starworkInit` and `starworkSpawn` can be discovered and used by Codex.
+StarWork 的基础能力是“让 AI 读懂并安全接手项目”。在此基础上，你可以按需要开启更多功能。
 
-For a fuller test script, see [docs/alpha-test-guide.md](docs/alpha-test-guide.md).
+### 项目知识库
 
-## Development
+适合资料多、规则多、需要长期复用背景的项目。你可以把客户信息、产品规则、术语解释、复盘结论和长期判断沉淀到项目知识库里，让后续 AI 不再只依赖聊天记录。
 
-Run the test suite:
+### 多智能体分工
 
-```bash
-npm test
-```
+适合一个项目里有多类工作要同时推进的情况。你可以把产品规划、开发、验收、资料整理等职责分给不同 Agent，StarWork 会记录每个 Agent 负责什么、能改哪里、要交接什么。
+
+### 项目中心
+
+适合同时管理多个项目的用户。项目中心可以登记多个项目工作台，帮助你从一个入口创建、查看和巡检不同项目。
+
+### 旧项目诊断
+
+适合已经有很多历史文件、AI 规则或旧模板的目录。StarWork 可以先诊断目录状态，再给出保守的接入或升级建议。
+
+## 给 AI 工具安装 StarWork Skills
+
+如果你希望 AI 更懂 StarWork 的使用流程，可以安装 StarWork Skills。安装后，普通请求先交给 `starwork` 主入口；明确的知识库、多智能体、诊断或初始化场景，也可以直接点名对应专家能力。
 
-Preview the npm package contents:
+当前默认面向 Codex：
 
 ```bash
-npm pack --dry-run
+npx skills add jennie-shawn/StarWork -g -a codex -y
 ```
+
+安装后，AI 会拥有一个 StarWork 主入口和几个专家 Skills，可以更自然地帮你：
+
+- 判断你现在应该走哪个 StarWork 能力。
+- 创建或接入项目工作台。
+- 诊断旧目录能否升级为 StarWork 工作台。
+- 开启和维护项目知识库。
+- 创建多个 Agent 分工协作。
+
+更完整的安装说明见 [Agent 安装指南](docs/agent-install-guide.md)。
+
+## 当前状态
+
+StarWork 目前处于 alpha 测试阶段，适合愿意尝鲜、愿意反馈体验问题的用户。
+
+当前版本重点关注：
+
+- 第一次初始化是否容易理解。
+- 预览和写入是否让人放心。
+- AI 是否能正确读取项目规则。
+- 知识库和多 Agent 分工是否真的减少重复解释。
+- 项目中心是否适合管理多个项目。
+
+如果你正在试用，欢迎重点反馈：哪里看不懂、哪里不放心、哪里不像一个普通用户会说的话。
+
+## 继续了解
+
+- [A 测安装指南](docs/alpha-test-guide.md)
+- [Agent 安装指南](docs/agent-install-guide.md)
+- [CLI 与 Skill 能力表](docs/cli-skill-registry.html)

package/adapters/README.md

@@ -3,3 +3,37 @@
 这里存放不同 Agent 的适配层，如 Codex、Claude Code、Cursor、Trae 等。
 
 适配层不混入 StarWork Core。
+
+## 当前定位
+
+Adapter 是 StarWork 的全局宿主适配层，不只服务 MultiAgent。
+
+它负责把 StarWork 工作台协议翻译成不同 AI 宿主能正确读取、正确行动、正确保存上下文的方式，包括：
+
+- 规则入口
+- Skill 识别
+- 会话能力
+- transcript / memory 边界
+- 宿主 CLI / API 探测
+- 私有状态安全边界
+
+## v0.1 当前进度
+
+Host Adapter v0.1 已先落地底座：
+
+- `contract.md`：定义 adapter profile、工作台 adapter state 和宿主安全边界。
+- `codex/`、`claude-code/`、`cursor/`、`trae/`：分别维护 `profile.json`、`rules.md`、`safety.md`。
+- `starwork adapt <host|all> --capabilities`：只读输出宿主能力，不改工作台。
+- `starwork adapt <host|all>`：写入宿主规则入口、Skill 目录和 `.starwork/adapters.json`。
+- `starwork doctor --host <host|all>`：检查宿主入口、Skill 目录、Cursor / Trae frontmatter、Trae disabled config 和不安全能力声明。
+- `starwork init --adapter <host|all>`：初始化完成后继续生成对应宿主入口。
+- `starwork multiagent`：Claude Code 可用 `CLAUDE_CODE_SESSION_ID` 绑定和 `claude --resume` 继续命令；Cursor 仅做 `agent-transcripts/<uuid>/<uuid>.jsonl` 只读摘要；Trae 仅保留人工操作入口；二者都不伪装后台送达。
+
+Cursor transcript 路径兼容、Claude Code 真实本机 transcript 路径适配和更完整用户文档仍需继续 A 测打磨。Trae 会话私有存储不作为 StarWork 读取目标。
+
+产品规划事实源见：
+
+```text
+product/planning/features/host-adapters/specs/v0.1.md
+product/planning/features/host-adapters/specs/v0.1-implementation.md
+```

package/adapters/claude-code/profile.json

@@ -0,0 +1,55 @@
+{
+  "schema": "starwork.adapter.profile.v0.1",
+  "host": "claude-code",
+  "label": "Claude Code",
+  "version": "0.1",
+  "rules": {
+    "entry_file": "CLAUDE.md",
+    "can_generate_entry": "supported",
+    "can_update_entry": "partial",
+    "supports_project_scope": "supported",
+    "supports_nested_rules": "unknown"
+  },
+  "skills": {
+    "system_install": "manual",
+    "project_mount": "manual",
+    "primary_project_dir": ".claude/skills/",
+    "project_mount_dirs": [".claude/skills/", ".agents/skills/"],
+    "host_native_dirs": [".claude/skills/"],
+    "global_dirs": ["~/.claude/skills/"],
+    "conflict_priority": [".claude/skills/", ".agents/skills/"],
+    "discovery": "manual",
+    "trigger_style": "rules-guided",
+    "adapter_rule_required": true
+  },
+  "sessions": {
+    "detect_current": "supported",
+    "rename": "partial",
+    "list": "partial",
+    "read": "supported",
+    "continue": "supported",
+    "send_message": "manual",
+    "create": "partial",
+    "pin": "unsupported",
+    "archive": "unsupported"
+  },
+  "memory": {
+    "transcript_read": "supported",
+    "transcript_write": "unsupported",
+    "summary_visible": "unsupported",
+    "project_memory": "supported",
+    "export": "partial"
+  },
+  "commands": {
+    "cli_available": "partial",
+    "api_available": "unsupported",
+    "requires_auth": "partial",
+    "can_probe": "supported"
+  },
+  "safety": {
+    "private_paths_readonly": ["~/.claude/projects/**", "~/.claude/sessions/**"],
+    "never_write_paths": ["~/.claude/projects/**/*.jsonl", "~/.claude.json"],
+    "destructive_commands": ["claude project purge"],
+    "degradation_required": ["sessions.send_message", "sessions.pin", "sessions.archive"]
+  }
+}

package/adapters/claude-code/rules.md

@@ -0,0 +1,13 @@
+# Claude Code Adapter Rules
+
+Claude Code uses `CLAUDE.md` as its project rule entry.
+
+The entry should point Claude Code back to:
+
+- `AGENTS.md`
+- `.starwork/workspace.json`
+- `.starwork/skills.json`
+- `.claude/skills/`
+- `.agents/skills/`
+
+Claude Code can bind or resume sessions, and transcripts may be read as candidate evidence. It cannot safely receive background messages to another session in StarWork v0.1.

package/adapters/claude-code/safety.md

@@ -0,0 +1,6 @@
+# Claude Code Adapter Safety
+
+- Never write Claude Code transcript JSONL files.
+- Never write `~/.claude.json`.
+- Never run destructive commands such as `claude project purge`.
+- Treat transcript content as candidate evidence only, not as StarWork formal memory.

package/adapters/codex/profile.json

@@ -0,0 +1,55 @@
+{
+  "schema": "starwork.adapter.profile.v0.1",
+  "host": "codex",
+  "label": "Codex",
+  "version": "0.1",
+  "rules": {
+    "entry_file": "AGENTS.md",
+    "can_generate_entry": "supported",
+    "can_update_entry": "partial",
+    "supports_project_scope": "supported",
+    "supports_nested_rules": "partial"
+  },
+  "skills": {
+    "system_install": "supported",
+    "project_mount": "supported",
+    "primary_project_dir": ".agents/skills/",
+    "project_mount_dirs": [".agents/skills/"],
+    "host_native_dirs": [".agents/skills/"],
+    "global_dirs": ["~/.agents/skills/"],
+    "conflict_priority": [".agents/skills/"],
+    "discovery": "partial",
+    "trigger_style": "rules-guided",
+    "adapter_rule_required": true
+  },
+  "sessions": {
+    "detect_current": "partial",
+    "rename": "supported",
+    "list": "supported",
+    "read": "supported",
+    "continue": "supported",
+    "send_message": "supported",
+    "create": "supported",
+    "pin": "partial",
+    "archive": "unsupported"
+  },
+  "memory": {
+    "transcript_read": "partial",
+    "transcript_write": "unsupported",
+    "summary_visible": "partial",
+    "project_memory": "supported",
+    "export": "partial"
+  },
+  "commands": {
+    "cli_available": "supported",
+    "api_available": "partial",
+    "requires_auth": "partial",
+    "can_probe": "supported"
+  },
+  "safety": {
+    "private_paths_readonly": [],
+    "never_write_paths": [],
+    "destructive_commands": [],
+    "degradation_required": ["sessions.archive"]
+  }
+}

package/adapters/codex/rules.md

@@ -0,0 +1,12 @@
+# Codex Adapter Rules
+
+Codex uses `AGENTS.md` as the primary project rule entry.
+
+The adapter should ensure Codex can find:
+
+- `AGENTS.md`
+- `.starwork/workspace.json`
+- `.starwork/skills.json`
+- `.agents/skills/`
+
+Codex can support automatic MultiAgent `launch`, `read`, and `instruct`, but completion must still be verified through StarWork state and target thread reads.

package/adapters/codex/safety.md

@@ -0,0 +1,5 @@
+# Codex Adapter Safety
+
+- Do not write Codex private runtime state.
+- Do not treat thread history as StarWork formal project memory.
+- If a turn is started but completion is not observed, report `started_unverified`, not completed delivery.

package/adapters/contract.md

@@ -0,0 +1,64 @@
+# StarWork Host Adapter Contract
+
+Host Adapter is the StarWork layer that translates the workspace protocol for a concrete AI host.
+
+It does not redefine Core, Kit, or Pack structure. It records what each host can read, generate, mount, inspect, continue, or only handle manually.
+
+## Profile Schema
+
+Each built-in host has:
+
+```text
+product/adapters/<host>/profile.json
+product/adapters/<host>/rules.md
+product/adapters/<host>/safety.md
+```
+
+`profile.json` must use:
+
+```json
+{
+  "schema": "starwork.adapter.profile.v0.1",
+  "host": "cursor",
+  "label": "Cursor",
+  "version": "0.1",
+  "rules": {},
+  "skills": {},
+  "sessions": {},
+  "memory": {},
+  "commands": {},
+  "safety": {}
+}
+```
+
+## Capability Levels
+
+Only these values are valid:
+
+```text
+supported | partial | manual | unsupported | unknown
+```
+
+- `supported`: stable automatic behavior.
+- `partial`: available but incomplete, environment-dependent, or not stable enough to promise.
+- `manual`: StarWork can generate instructions or handoff text, but the user must act.
+- `unsupported`: not supported or not safe to rely on.
+- `unknown`: not researched enough to make a promise.
+
+`partial`, `manual`, and `unknown` must never be described as automatic completion.
+
+## State
+
+Workspace adapter state lives in:
+
+```text
+.starwork/adapters.json
+```
+
+`.starwork/workspace.json.adapters` remains a short compatibility summary only.
+
+## Safety Rules
+
+Adapters must not write host private transcripts, private databases, encrypted stores, or global configuration unless the user explicitly asks for a documented host-level action.
+
+Host private history is never a StarWork source of truth.

package/adapters/cursor/profile.json

@@ -0,0 +1,60 @@
+{
+  "schema": "starwork.adapter.profile.v0.1",
+  "host": "cursor",
+  "label": "Cursor",
+  "version": "0.1",
+  "rules": {
+    "entry_file": ".cursor/rules/starwork.mdc",
+    "can_generate_entry": "supported",
+    "can_update_entry": "partial",
+    "supports_project_scope": "supported",
+    "supports_nested_rules": "supported"
+  },
+  "skills": {
+    "system_install": "manual",
+    "project_mount": "supported",
+    "primary_project_dir": ".cursor/skills/",
+    "project_mount_dirs": [".cursor/skills/", ".agents/skills/"],
+    "host_native_dirs": [".cursor/skills/", ".agents/skills/", ".claude/skills/", ".codex/skills/"],
+    "global_dirs": ["~/.cursor/skills/", "~/.agents/skills/", "~/.claude/skills/", "~/.codex/skills/"],
+    "conflict_priority": [".cursor/skills/", ".agents/skills/", ".claude/skills/", ".codex/skills/"],
+    "discovery": "supported",
+    "trigger_style": "native-skill-discovery",
+    "adapter_rule_required": true,
+    "frontmatter": {
+      "required": ["name", "description"],
+      "name_pattern": "^[a-z0-9-]+$",
+      "name_matches_parent": true
+    }
+  },
+  "sessions": {
+    "detect_current": "partial",
+    "list": "partial",
+    "read": "partial",
+    "continue": "manual",
+    "send_message": "manual",
+    "create": "unsupported",
+    "rename": "partial",
+    "pin": "unsupported",
+    "archive": "unsupported"
+  },
+  "memory": {
+    "transcript_read": "partial",
+    "transcript_write": "unsupported",
+    "summary_visible": "unknown",
+    "project_memory": "supported",
+    "export": "partial"
+  },
+  "commands": {
+    "cli_available": "partial",
+    "api_available": "unsupported",
+    "requires_auth": "partial",
+    "can_probe": "partial"
+  },
+  "safety": {
+    "private_paths_readonly": ["~/Library/Application Support/Cursor/**"],
+    "never_write_paths": ["~/Library/Application Support/Cursor/**/*.vscdb", "~/Library/Application Support/Cursor/**/*.sqlite"],
+    "destructive_commands": [],
+    "degradation_required": ["sessions.pin", "sessions.archive"]
+  }
+}

package/adapters/cursor/rules.md

@@ -0,0 +1,7 @@
+# Cursor Adapter Rules
+
+Cursor uses `.cursor/rules/starwork.mdc` as the StarWork entry.
+
+Cursor can discover project Skills from `.cursor/skills/` and `.agents/skills/`, and can also see compatible `.claude/skills/` and `.codex/skills/` directories. StarWork still treats `.starwork/skills.json` as the project Skill fact source.
+
+Cursor session automation is read-only in v0.2. StarWork may summarize `agent-transcripts/<uuid>/<uuid>.jsonl` for `multiagent read/status --host`, but must not write Cursor transcripts, create chats, or claim automatic cross-session delivery.

package/adapters/cursor/safety.md

@@ -0,0 +1,6 @@
+# Cursor Adapter Safety
+
+- Do not write Cursor private databases or chat history.
+- Only summarize Cursor `agent-transcripts/<uuid>/<uuid>.jsonl` as incomplete host observation.
+- Do not treat Cursor transcript or UI state as StarWork formal memory.
+- Do not claim background delivery unless a supported, verified route exists.

package/adapters/trae/profile.json

@@ -0,0 +1,61 @@
+{
+  "schema": "starwork.adapter.profile.v0.1",
+  "host": "trae",
+  "label": "Trae",
+  "version": "0.1",
+  "rules": {
+    "entry_file": ".trae/rules/starwork.md",
+    "can_generate_entry": "supported",
+    "can_update_entry": "partial",
+    "supports_project_scope": "supported",
+    "supports_nested_rules": "unknown"
+  },
+  "skills": {
+    "system_install": "manual",
+    "project_mount": "supported",
+    "primary_project_dir": ".trae/skills/",
+    "project_mount_dirs": [".trae/skills/", ".agents/skills/"],
+    "host_native_dirs": [".trae/skills/", ".agents/skills/"],
+    "global_dirs": ["~/.trae-cn/skills", "%userprofile%/.trae-cn/skills"],
+    "conflict_priority": [".trae/skills/", ".agents/skills/"],
+    "discovery": "supported",
+    "trigger_style": "native-skill-discovery",
+    "adapter_rule_required": true,
+    "frontmatter": {
+      "required": ["name", "description"],
+      "name_pattern": "^[a-z0-9-]+$",
+      "name_matches_parent": true
+    },
+    "disabled_config": ".trae/skill-config.json"
+  },
+  "sessions": {
+    "detect_current": "unsupported",
+    "list": "unsupported",
+    "read": "unsupported",
+    "continue": "manual",
+    "send_message": "manual",
+    "create": "unsupported",
+    "rename": "unsupported",
+    "pin": "unsupported",
+    "archive": "unsupported"
+  },
+  "memory": {
+    "transcript_read": "unsupported",
+    "transcript_write": "unsupported",
+    "summary_visible": "unsupported",
+    "project_memory": "supported",
+    "export": "unsupported"
+  },
+  "commands": {
+    "cli_available": "partial",
+    "api_available": "unsupported",
+    "requires_auth": "partial",
+    "can_probe": "unsupported"
+  },
+  "safety": {
+    "private_paths_readonly": ["~/Library/Application Support/Trae/**", "~/Library/Application Support/Trae CN/**"],
+    "never_write_paths": ["**/database.db", "**/*.vscdb", "**/*.sqlite"],
+    "destructive_commands": [],
+    "degradation_required": ["sessions.read", "sessions.send_message", "sessions.create", "sessions.continue", "sessions.pin", "sessions.archive"]
+  }
+}