Add selectable CASAN IDE integrations
This commit is contained in:
@@ -53,10 +53,11 @@ cục bộ), `CASAN_DIST_URL` (tải tarball), `CASAN_NO_PATH_LINK=1` (không t
|
||||
|
||||
```bash
|
||||
cd <dự-án-của-bạn>
|
||||
casan init # project id lấy theo tên thư mục, level=devkit
|
||||
casan init # interactive: chọn Claude, Codex, VS Code/Copilot
|
||||
# hoặc chọn level áp dụng cho project:
|
||||
casan init --level 1 --project my-app # L1: chỉ gate + hook Plan-20
|
||||
casan init --level 2 --project my-app # L2 (mặc định): + CI workflow + domain-pack
|
||||
casan init --level 1 --project my-app --client claude
|
||||
casan init --level 2 --project my-app --client claude,codex
|
||||
casan init --project my-app --client vscode-copilot --vscode-install yes
|
||||
casan level show # xem level đã cài + level project
|
||||
casan level set 2 # đổi level project (không cần init lại)
|
||||
```
|
||||
@@ -79,17 +80,50 @@ casan level set 2 # đổi level project (không cần ini
|
||||
| `.casan/config.json` | project id, enforcement/integration mode, clients |
|
||||
| `.casan/version.lock` | **pin** harness version + hash gate-code |
|
||||
| `.casan/agentic.env` | feature flags bridge Plan-20 |
|
||||
| `.casan/casan-hook.py` | bootstrap stdlib: load config, resolve + verify harness global, dispatch adapter |
|
||||
| `.specify/` | thư mục state runtime (logs/trace/admission) |
|
||||
| `.claude/settings.json` | hook Claude Code (Plan-20) |
|
||||
| `.codex/hooks.json`, `config.toml` | hook Codex (Plan-20) |
|
||||
| `.codex/hooks.json` | hook Codex theo schema hiện hành; cần review/trust bằng `/hooks` |
|
||||
| `.vscode/extensions.json` | recommendations cho IDE đã chọn |
|
||||
|
||||
Tham số: `--client claude|codex|all` (mặc định `all`), `--mode observe|enforce`
|
||||
(mặc định `observe`), `--integration-mode project_hook|managed_hook|casan_owned`,
|
||||
`--target <dir>` (mặc định thư mục hiện tại).
|
||||
Tham số `--client` có thể lặp hoặc comma-separated:
|
||||
`claude`, `codex`, `vscode-copilot`, `all`, `none`. Khi chạy `casan init` trực
|
||||
tiếp trong terminal, CLI hiển thị menu chọn. Trong automation không có TTY,
|
||||
mặc định tương thích ngược là `claude,codex`.
|
||||
|
||||
`--mode observe|enforce` mặc định `enforce`; dùng `observe` chỉ cho pilot
|
||||
telemetry-only. `--integration-mode` nhận
|
||||
`project_hook|managed_hook|casan_owned`; `--target <dir>` mặc định là thư mục
|
||||
hiện tại.
|
||||
|
||||
Bootstrap `.casan/casan-hook.py` tự đọc `config.json`; developer không còn phải
|
||||
source `.casan/agentic.env` trước khi mở IDE. Mỗi invocation kiểm tra live hash
|
||||
của harness global so với `version.lock` trước khi chạy adapter.
|
||||
|
||||
Sau `init`, developer gõ prompt bình thường trong client — trace H1→H7 + H6 theo
|
||||
Plan-20. Repo chỉ có mấy file config nhỏ; nâng cấp harness làm ở `$CASAN_HOME`.
|
||||
|
||||
### Capability theo client
|
||||
|
||||
| Lựa chọn | Trải nghiệm | Bước trust/cài đặt bắt buộc |
|
||||
|---|---|---|
|
||||
| `claude` | Claude Code CLI và extension chính thức dùng project hooks | Mở trusted project; hook chạy tự động |
|
||||
| `codex` | Codex CLI và IDE extension dùng `.codex/hooks.json` | Mở `/hooks`, review và trust đúng hook hash |
|
||||
| `vscode-copilot` | GitHub Copilot Chat qua route **explicit `@casan`** | Cài VSIX do init tạo/cài; dùng `@casan <prompt>` |
|
||||
|
||||
GitHub Copilot Chat mặc định **không** có public API để CASAN intercept mọi
|
||||
prompt. Chỉ route `@casan` là `casan_owned`; participant detection/built-in
|
||||
Copilot không được quảng bá là certified.
|
||||
|
||||
Kiểm tra sau init:
|
||||
|
||||
```bash
|
||||
casan doctor
|
||||
casan doctor --client claude
|
||||
casan doctor --client codex
|
||||
casan doctor --client vscode-copilot
|
||||
```
|
||||
|
||||
## 3. Pin + Verify (giữ đảm bảo bảo mật khi harness ở ngoài repo)
|
||||
|
||||
Vì harness không nằm trong repo, dự án **pin** version + hash gate-code lúc
|
||||
|
||||
Reference in New Issue
Block a user