licell 1.0.6 → 1.0.7

package/README.en.md

@@ -9,7 +9,7 @@ It is not just a bag of cloud commands. It is organized around one primary deliv
 - one main entry: `deploy`
 - one project state file: `.licell/project.json`
 - one set of atomic resource commands: `fn` / `oss` / `dns` / `domain`
-- one agent-facing surface: `--help` / `--output json` / `mcp` / `skills`
+- one agent-facing surface: `catalog` / `--help` / `--output json` / `capability` / `skills`
 
 Default region is `cn-hangzhou`. For agent automation, use a dedicated test account or isolated region instead of sharing a production environment directly. For team sharing, use the team auth distribution workflow described below.
 
@@ -30,6 +30,8 @@ Licell currently covers:
 - custom domains, HTTPS, CDN, DNS
 - ACR / Docker image deployment
 - serverless database and cache helpers
+- ACK / ACS cluster and workload inventory
+- protocol-driven discovery and controlled raw API fallback across 16,242 Alibaba Cloud APIs
 - MCP / skills / JSON output / shared-doc generation for agent automation
 
 ---
@@ -247,6 +249,14 @@ Usage and security guidance:
 
 ## Agent Interfaces
 
+Start every natural-language Alibaba Cloud task with the curated command catalog:
+
+```bash
+licell catalog --output json
+```
+
+If no curated command covers the outcome, continue with `capability products/search/describe`, then follow `execution.preferred`. Raw writes require `--dry-run`, explicit `--yes`, and read-back verification through `nextActions[]`.
+
 ### 1. Structured help
 
 Licell help is designed for both humans and agents.

package/README.md

@@ -521,9 +521,11 @@ licell e2e cleanup <runId>
 
 ### Agent Contract
 
-- 发现命令目录：`licell catalog --output json`。
-- 读取单命令契约：`licell <command> --help --output json`。
-- 真正执行命令：`licell <command> --output json`，并过滤 `@@LICELL_JSON@@` 前缀逐行解析。
+- 始终先发现领域命令：`licell catalog --output json`。
+- 命中领域命令：读取 `licell <command> --help --output json`，再执行该命令。
+- 未命中领域命令：依次执行 `capability products/search/describe --output json`，并读取 `execution.preferred`。
+- raw 写操作必须先 `--dry-run`，再显式 `--yes`，最后按 `nextActions[]` 回读验证。
+- 解析执行结果时，只消费带 `@@LICELL_JSON@@` 前缀的逐行 JSON record。
 - 对 `type=event` 的 record，优先读取稳定字段 `stage` / `action` / `status` / `source` / `terminal`。
 - 对 `type=error` 的 record，优先读取 `nextActions[]` 获取首选补救步骤。
 
@@ -533,6 +535,7 @@ licell e2e cleanup <runId>
 - `licell <command> --help --output json`：读取 `help.kind` / `help.schemaVersion`；当前为 `licell-help@1.0`。
 - `licell catalog --output json`：读取 `kind` / `schemaVersion`；当前为 `licell-agent-command-catalog@1.0`。
 - `licell catalog --output json` 还会显式声明 help schema 与 CLI record schema：`licell-help@1.0` / `licell-cli-record@1.0`。
+- 读取 `catalog.agentWorkflow` 获取“领域命令优先、raw capability 兜底”的自然语言路由契约；只有两层发现都失败，才可判定不支持。
 - Agent 优先读取 `nextActions[]` 作为稳定下一步入口；`recommendedFlow` / `decisionGuide` / `remediation[]` 作为补充语义层。
 - 命令自己的业务结果字段继续读取对应命令 help / catalog 里的 `result`；下面三组 contract 只描述公共 CLI record 包络。
 
@@ -751,6 +754,8 @@ licell e2e cleanup <runId>
 | `licell ecs rm <instanceId>` | 删除（释放）ECS 实例（delete 的别名） | `--region`, `--dry-run`, `--yes` |
 | `licell ecs start <instanceId>` | 启动 ECS 实例 | `--region`, `--dry-run` |
 | `licell ecs stop <instanceId>` | 停止 ECS 实例 | `--region`, `--dry-run`, `--yes` |
+| `licell k8s clusters` | 列出当前地域的 ACK / ACS Kubernetes 集群 | `--region`, `--name` |
+| `licell k8s workloads <cluster>` | 只读查询 ACK / ACS 集群内已部署的工作负载和 Service | `--region`, `--private`, `--request-timeout` |
 
 #### Automation & Tooling