maxc-cli 0.1.2__tar.gz → 0.1.4__tar.gz

{maxc_cli-0.1.2 → maxc_cli-0.1.4}/MANIFEST.in

@@ -1,2 +1,3 @@
+recursive-include src/maxc_cli/skills *
 recursive-include skills/use-maxc-cli *
 recursive-include scripts *.py

maxc_cli-0.1.4/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: maxc-cli
+Version: 0.1.4
+Summary: Agent-native MaxCompute CLI for external coding agents
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8,<3.13
+Description-Content-Type: text/markdown
+Requires-Dist: PyYAML>=5.4
+Requires-Dist: pyodps
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# maxc-cli
+
+MaxCompute CLI — 不是 Agent，而是给 Agent 调用的结构化工具层。
+
+## 快速开始
+
+```bash
+pip install maxc-cli
+
+# 认证
+maxc auth login --from-env --json          # 从环境变量
+maxc auth login --access-id ID --secret-access-key KEY --project PROJ --endpoint URL --json
+
+# 确认就绪
+maxc auth whoami --json
+maxc agent context --json
+
+# 用
+maxc meta search "销售" --json
+maxc meta describe schema.table --json
+maxc query cost "SELECT * FROM schema.table WHERE ds='20260415'" --json
+maxc query "SELECT * FROM schema.table WHERE ds='20260415'" --json
+```
+
+## 命令一览
+
+| 家族 | 命令 | 说明 |
+|------|------|------|
+| **query** | `query [run]`, `query cost`, `query explain` | SQL 执行、成本估算、执行计划 |
+| **job** | `submit`, `status`, `wait`, `result`, `cancel`, `diagnose`, `list` | 异步任务全生命周期 |
+| **meta** | `list-tables`, `describe`, `search`, `search-columns`, `partitions`, `latest-partition`, `freshness`, `list-projects`, `list-schemas`, `semantic set/get/list-missing` | 元数据发现与语义管理 |
+| **data** | `sample`, `profile` | 数据采样与画像 |
+| **auth** | `login`, `login-external`, `whoami`, `can-i` | 认证与权限 |
+| **session** | `set`, `show`, `unset` | 项目/Schema 切换 |
+| **diff** | `schema`, `partition`, `data` | 表结构/分区/数据对比 |
+| **cache** | `build`, `build-status`, `status`, `clear` | 元数据缓存管理 |
+| **agent** | `context`, `skill`, `install-skill` | Agent 集成与 SKILL 安装 |
+
+所有命令支持 `--json` 输出 Envelope v2.0 结构化响应。
+
+## Agent 集成
+
+### 方式 1：SKILL HUB（主路径）
+
+SKILL HUB 安装 SKILL → Agent 读 SKILL.md → Agent 自己 `pip install maxc-cli`。
+
+### 方式 2：install-skill（内网兜底）
+
+先 pip install，再一键注册到 Agent 平台：
+
+```bash
+pip install maxc-cli
+maxc agent install-skill claude-code    # 或 cursor / windsurf / codex / qwen / qoder / qoderwork
+```
+
+`install-skill` 从独立仓库 [maxcompute-cli-guidance](https://gitlab.alibaba-inc.com/aone-open-skill/maxcompute-cli-guidance) 获取 SKILL.md + references/ 并安装到目标平台目录。
+
+### preflight 检查
+
+Agent 启动时应先运行：
+
+```bash
+maxc agent context --json   # 版本、认证状态、后端可达性、能力矩阵
+maxc agent skill --json     # SKILL.md 路径与 min_cli_version
+```
+
+## Envelope v2.0
+
+所有 `--json` 输出遵循统一结构：
+
+```json
+{
+  "version": "2.0",
+  "command": "meta.describe",
+  "command_id": "meta.describe",
+  "status": "success | failure",
+  "data": { ... },
+  "metadata": { ... },
+  "error": null | { "code": "...", "message": "...", "recovery_steps": [...] },
+  "agent_hints": {
+    "next_actions": ["maxc meta search --json", ...],
+    "action_ids": ["meta.search", ...],
+    "insights": [...],
+    "warnings": [...]
+  }
+}
+```
+
+- `action_ids`：稳定 dot-notation，用于程序化路由（`meta.describe`、`job.wait`）
+- `next_actions`：可直接 copy-paste 的 CLI 命令
+- `error.recovery_steps`：错误码对应的恢复步骤
+
+详见 [`docs/ENVELOPE_SPEC.md`](docs/ENVELOPE_SPEC.md)。
+
+## 项目结构
+
+```
+src/maxc_cli/
+├── cli.py               # argparse 命令注册
+├── app.py               # MaxCApp 业务逻辑
+├── models.py            # Envelope / AgentHints / QueryResult
+├── exceptions.py        # ErrorPayload + 9 个异常子类 + recovery_steps
+├── config.py            # YAML 配置加载
+├── cache.py             # LocalCache (SQLite)
+├── store.py             # JobStore (SQLite)
+├── output.py            # Rich / 纯文本渲染
+├── auth_providers.py    # AK-SK / NCS / 环境变量认证
+├── backend/             # ODPS 后端（query / meta / catalog / data / diff 五个 mixin）
+└── (skills/ 已迁移至独立仓库 aone-open-skill/maxcompute-cli-guidance)
+```
+
+## 文档
+
+| 文档 | 内容 |
+|------|------|
+| [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) | 三层架构、核心数据流、缓存/认证架构 |
+| [`docs/ENVELOPE_SPEC.md`](docs/ENVELOPE_SPEC.md) | Envelope v2.0 规范、pagination、error codes |
+| [`docs/ODPS_BACKEND.md`](docs/ODPS_BACKEND.md) | ODPS 后端 API 映射、限制与回退行为 |
+| [`docs/design.md`](docs/design.md) | 产品定位与命令体系 |
+| [`docs/implementation.md`](docs/implementation.md) | 当前代码的真实行为和输出契约 |
+| [`docs/roadmap.md`](docs/roadmap.md) | 路线图 |
+
+## 限制
+
+- **只读**：CLI 强制 SELECT-only，不支持 DDL/DML
+- **auth login**：AK/SK 明文存储于 `~/.maxc/config.yaml`（文件权限 0600）
+- **list-tables 分页**：CLI 侧 offset token，非服务端游标
+- **diff data**：按主键快照对比，非全量 diff
+
+## 开发
+
+```bash
+pip install -e .
+pytest tests/ -m unit    # 142 个单元测试
+```

maxc_cli-0.1.4/README.md

@@ -0,0 +1,135 @@
+# maxc-cli
+
+MaxCompute CLI — 不是 Agent，而是给 Agent 调用的结构化工具层。
+
+## 快速开始
+
+```bash
+pip install maxc-cli
+
+# 认证
+maxc auth login --from-env --json          # 从环境变量
+maxc auth login --access-id ID --secret-access-key KEY --project PROJ --endpoint URL --json
+
+# 确认就绪
+maxc auth whoami --json
+maxc agent context --json
+
+# 用
+maxc meta search "销售" --json
+maxc meta describe schema.table --json
+maxc query cost "SELECT * FROM schema.table WHERE ds='20260415'" --json
+maxc query "SELECT * FROM schema.table WHERE ds='20260415'" --json
+```
+
+## 命令一览
+
+| 家族 | 命令 | 说明 |
+|------|------|------|
+| **query** | `query [run]`, `query cost`, `query explain` | SQL 执行、成本估算、执行计划 |
+| **job** | `submit`, `status`, `wait`, `result`, `cancel`, `diagnose`, `list` | 异步任务全生命周期 |
+| **meta** | `list-tables`, `describe`, `search`, `search-columns`, `partitions`, `latest-partition`, `freshness`, `list-projects`, `list-schemas`, `semantic set/get/list-missing` | 元数据发现与语义管理 |
+| **data** | `sample`, `profile` | 数据采样与画像 |
+| **auth** | `login`, `login-external`, `whoami`, `can-i` | 认证与权限 |
+| **session** | `set`, `show`, `unset` | 项目/Schema 切换 |
+| **diff** | `schema`, `partition`, `data` | 表结构/分区/数据对比 |
+| **cache** | `build`, `build-status`, `status`, `clear` | 元数据缓存管理 |
+| **agent** | `context`, `skill`, `install-skill` | Agent 集成与 SKILL 安装 |
+
+所有命令支持 `--json` 输出 Envelope v2.0 结构化响应。
+
+## Agent 集成
+
+### 方式 1：SKILL HUB（主路径）
+
+SKILL HUB 安装 SKILL → Agent 读 SKILL.md → Agent 自己 `pip install maxc-cli`。
+
+### 方式 2：install-skill（内网兜底）
+
+先 pip install，再一键注册到 Agent 平台：
+
+```bash
+pip install maxc-cli
+maxc agent install-skill claude-code    # 或 cursor / windsurf / codex / qwen / qoder / qoderwork
+```
+
+`install-skill` 从独立仓库 [maxcompute-cli-guidance](https://gitlab.alibaba-inc.com/aone-open-skill/maxcompute-cli-guidance) 获取 SKILL.md + references/ 并安装到目标平台目录。
+
+### preflight 检查
+
+Agent 启动时应先运行：
+
+```bash
+maxc agent context --json   # 版本、认证状态、后端可达性、能力矩阵
+maxc agent skill --json     # SKILL.md 路径与 min_cli_version
+```
+
+## Envelope v2.0
+
+所有 `--json` 输出遵循统一结构：
+
+```json
+{
+  "version": "2.0",
+  "command": "meta.describe",
+  "command_id": "meta.describe",
+  "status": "success | failure",
+  "data": { ... },
+  "metadata": { ... },
+  "error": null | { "code": "...", "message": "...", "recovery_steps": [...] },
+  "agent_hints": {
+    "next_actions": ["maxc meta search --json", ...],
+    "action_ids": ["meta.search", ...],
+    "insights": [...],
+    "warnings": [...]
+  }
+}
+```
+
+- `action_ids`：稳定 dot-notation，用于程序化路由（`meta.describe`、`job.wait`）
+- `next_actions`：可直接 copy-paste 的 CLI 命令
+- `error.recovery_steps`：错误码对应的恢复步骤
+
+详见 [`docs/ENVELOPE_SPEC.md`](docs/ENVELOPE_SPEC.md)。
+
+## 项目结构
+
+```
+src/maxc_cli/
+├── cli.py               # argparse 命令注册
+├── app.py               # MaxCApp 业务逻辑
+├── models.py            # Envelope / AgentHints / QueryResult
+├── exceptions.py        # ErrorPayload + 9 个异常子类 + recovery_steps
+├── config.py            # YAML 配置加载
+├── cache.py             # LocalCache (SQLite)
+├── store.py             # JobStore (SQLite)
+├── output.py            # Rich / 纯文本渲染
+├── auth_providers.py    # AK-SK / NCS / 环境变量认证
+├── backend/             # ODPS 后端（query / meta / catalog / data / diff 五个 mixin）
+└── (skills/ 已迁移至独立仓库 aone-open-skill/maxcompute-cli-guidance)
+```
+
+## 文档
+
+| 文档 | 内容 |
+|------|------|
+| [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) | 三层架构、核心数据流、缓存/认证架构 |
+| [`docs/ENVELOPE_SPEC.md`](docs/ENVELOPE_SPEC.md) | Envelope v2.0 规范、pagination、error codes |
+| [`docs/ODPS_BACKEND.md`](docs/ODPS_BACKEND.md) | ODPS 后端 API 映射、限制与回退行为 |
+| [`docs/design.md`](docs/design.md) | 产品定位与命令体系 |
+| [`docs/implementation.md`](docs/implementation.md) | 当前代码的真实行为和输出契约 |
+| [`docs/roadmap.md`](docs/roadmap.md) | 路线图 |
+
+## 限制
+
+- **只读**：CLI 强制 SELECT-only，不支持 DDL/DML
+- **auth login**：AK/SK 明文存储于 `~/.maxc/config.yaml`（文件权限 0600）
+- **list-tables 分页**：CLI 侧 offset token，非服务端游标
+- **diff data**：按主键快照对比，非全量 diff
+
+## 开发
+
+```bash
+pip install -e .
+pytest tests/ -m unit    # 142 个单元测试
+```

maxc_cli-0.1.4/scripts/regression_test.py

@@ -0,0 +1,326 @@
+#!/usr/bin/env python3
+"""Pre-release regression test - runs all CLI commands against real MaxCompute backend."""
+import json
+import os
+import sys
+import tempfile
+from io import StringIO
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "src"))
+from maxc_cli.cli import run
+
+RESULTS = []
+TABLE = None
+TABLE_COL = None
+JOB_ID = None
+
+def assert_eq(a, b): assert a == b, f"expected {b!r}, got {a!r}"
+def assert_true(v): assert v, f"expected truthy, got {v!r}"
+def assert_key(d, k): assert k in d, f"missing key: {k!r} in {list(d.keys())}"
+def assert_type(v, t): assert isinstance(v, t), f"expected {t.__name__}, got {type(v).__name__}"
+
+def run_cmd(label, argv, expect_code=0, check=None):
+    global JOB_ID
+    stdout, stderr = StringIO(), StringIO()
+    code = run(argv, cwd=Path.cwd(), stdout=stdout, stderr=stderr)
+    out = stdout.getvalue()
+    err = stderr.getvalue()
+    try:
+        data = json.loads(out) if out.strip() else {}
+    except json.JSONDecodeError:
+        data = {"_raw": out[:300]}
+
+    ok = (expect_code is None) or (code == expect_code)
+    detail = ""
+    if not ok:
+        detail = f"exit_code={code}, expected={expect_code}"
+        if err.strip():
+            detail += f" stderr={err[:200]}"
+    if ok and check:
+        try:
+            check(data)
+        except Exception as e:
+            ok = False
+            detail = str(e)
+
+    icon = "PASS" if ok else "FAIL"
+    RESULTS.append((label, icon, detail))
+    suffix = f"  -- {detail}" if detail else ""
+    print(f"  [{icon}] {label}{suffix}")
+    sys.stdout.flush()
+    return code, data
+
+def pdata(d):
+    return d.get("data", {})
+
+
+# ===========================================================
+print("\n=== 1. Auth ===")
+# ===========================================================
+run_cmd("1.1 auth whoami", ["auth", "whoami", "--json"],
+    check=lambda d: (
+        assert_eq(d["status"], "success"),
+        assert_true(pdata(d)["identity"]["authenticated"]),
+    ))
+
+# Get test table
+_, tdata = run_cmd("(preflight) list-tables", ["meta", "list-tables", "--json"])
+tables = pdata(tdata).get("tables", [])
+TABLE = tables[0]["table_name"] if tables else None
+if not TABLE:
+    print("  [SKIP] No tables available, aborting")
+    sys.exit(1)
+print(f"  >> Test table: {TABLE}")
+
+# Describe to get column name
+_, ddata = run_cmd("(preflight) describe", ["meta", "describe", TABLE, "--json"])
+cols = pdata(ddata).get("table", {}).get("schema", [])
+TABLE_COL = cols[0]["name"] if cols else "id"
+print(f"  >> Test column: {TABLE_COL}")
+
+run_cmd("1.2 auth can-i SELECT", ["auth", "can-i", "--table", TABLE, "--operation", "SELECT", "--json"],
+    expect_code=None,  # may be 0 or 1 depending on permissions
+    check=lambda d: assert_key(pdata(d), "authorization"))
+
+run_cmd("1.3 auth can-i --brief", ["auth", "can-i", "--table", TABLE, "--operation", "SELECT", "--brief", "--json"],
+    expect_code=None,  # may be 0 or 1
+    check=lambda d: assert_true(d["status"] in ("success", "failure")))
+
+
+# ===========================================================
+print("\n=== 2. Meta ===")
+# ===========================================================
+run_cmd("2.1 meta list-tables", ["meta", "list-tables", "--json"],
+    check=lambda d: assert_true(len(pdata(d).get("tables", [])) > 0))
+
+run_cmd("2.2 meta describe", ["meta", "describe", TABLE, "--json"],
+    check=lambda d: (
+        assert_eq(pdata(d)["table"]["table_name"], TABLE),
+        assert_key(pdata(d)["table"], "schema"),
+    ))
+
+run_cmd("2.3 meta describe --full", ["meta", "describe", TABLE, "--full", "--json"],
+    check=lambda d: assert_eq(d["status"], "success"))
+
+run_cmd("2.4 meta search", ["meta", "search", "test", "--json"],
+    check=lambda d: assert_key(pdata(d)["search"], "matches"))
+
+run_cmd("2.5 meta search-columns", ["meta", "search-columns", "id", "--json"],
+    check=lambda d: assert_key(pdata(d)["search"], "matches"))
+
+run_cmd("2.6 meta partitions", ["meta", "partitions", TABLE, "--json"],
+    check=lambda d: assert_key(pdata(d), "partitions"))
+
+run_cmd("2.7 meta latest-partition", ["meta", "latest-partition", TABLE, "--json"],
+    check=lambda d: assert_key(pdata(d)["partition"], "has_partitions"))
+
+run_cmd("2.8 meta freshness", ["meta", "freshness", TABLE, "--json"],
+    check=lambda d: assert_key(pdata(d)["freshness"], "freshness_status"))
+
+run_cmd("2.9 meta list-projects", ["meta", "list-projects", "--json"],
+    check=lambda d: assert_type(pdata(d)["projects"], list))
+
+run_cmd("2.10 meta list-schemas", ["meta", "list-schemas", "--json"],
+    expect_code=None,  # may fail if catalog not available
+    check=lambda d: assert_true(d["status"] in ("success", "failure")))
+
+
+# ===========================================================
+print("\n=== 3. Meta Semantic ===")
+# ===========================================================
+run_cmd("3.1 meta semantic set", ["meta", "semantic", "set", TABLE, "--desc", "regression test desc", "--json"],
+    check=lambda d: assert_eq(d["status"], "success"))
+
+run_cmd("3.2 meta semantic get", ["meta", "semantic", "get", TABLE, "--json"],
+    check=lambda d: assert_eq(d["status"], "success"))
+
+run_cmd("3.3 meta semantic list-missing", ["meta", "semantic", "list-missing", "--json"],
+    check=lambda d: assert_eq(d["status"], "success"))
+
+
+# ===========================================================
+print("\n=== 4. Query ===")
+# ===========================================================
+run_cmd("4.1 query simple", ["query", "SELECT 1 AS c1, 'test' AS c2", "--json", "--force"],
+    check=lambda d: (
+        assert_eq(d["status"], "success"),
+        assert_true(len(pdata(d)["result"]["rows"]) == 1),
+    ))
+
+run_cmd("4.2 query cost", ["query", "cost", "SELECT 1 AS c1", "--json", "--force"],
+    check=lambda d: assert_key(pdata(d)["analysis"], "cost_model"))
+
+run_cmd("4.3 query explain", ["query", "explain", "SELECT 1 AS c1", "--json", "--force"],
+    check=lambda d: assert_eq(pdata(d)["analysis"]["analysis_mode"], "explain"))
+
+run_cmd("4.4 query pagination",
+    ["query", "SELECT 1 AS id UNION ALL SELECT 2 UNION ALL SELECT 3 UNION ALL SELECT 4 UNION ALL SELECT 5",
+     "--page-size", "2", "--json", "--force"],
+    check=lambda d: (
+        assert_true(pdata(d)["pagination"]["has_more"]),
+        assert_true(pdata(d)["pagination"]["next_cursor"] is not None),
+    ))
+
+run_cmd("4.5 query dry-run", ["query", "SELECT 1", "--dry-run", "--json", "--force"],
+    check=lambda d: assert_eq(pdata(d)["result"]["returned_rows"], 0))
+
+run_cmd("4.6 query wait=0", ["query", "SELECT 1 AS async_test", "--wait", "0", "--json", "--force"],
+    check=lambda d: (
+        assert_eq(d["status"], "pending"),
+        assert_key(pdata(d), "job"),
+    ))
+
+tmpfile = Path(tempfile.mktemp(suffix=".csv"))
+run_cmd("4.7 query --output csv",
+    ["query", "SELECT 1 AS a, 2 AS b", "--json", "--force", "--output", str(tmpfile), "--output-format", "csv"],
+    check=lambda d: assert_eq(d["status"], "success"))
+if tmpfile.exists():
+    print(f"       CSV file created: {tmpfile.stat().st_size} bytes")
+    tmpfile.unlink()
+else:
+    RESULTS.append(("4.7b csv file exists", "FAIL", "file not created"))
+
+
+# ===========================================================
+print("\n=== 5. Query: New Features ===")
+# ===========================================================
+run_cmd("5.1 masking (phone/email/password)",
+    ["query", "SELECT 1 as id, '13812345678' as phone, 'alice@example.com' as email, 'secret' as password",
+     "--force", "--json"],
+    check=lambda d: (
+        assert_eq(pdata(d)["result"]["rows"][0]["phone"], "138****5678"),
+        assert_eq(pdata(d)["result"]["rows"][0]["email"], "a***@example.com"),
+        assert_eq(pdata(d)["result"]["rows"][0]["password"], "******"),
+        assert_true(any("masked" in w.lower() for w in d.get("agent_hints", {}).get("warnings", []))),
+    ))
+
+run_cmd("5.2 LIMIT truncation warning",
+    ["query", "SELECT t.* FROM (SELECT 1 as id UNION ALL SELECT 2 UNION ALL SELECT 3 UNION ALL SELECT 4 UNION ALL SELECT 5) t",
+     "--max-rows", "2", "--force", "--json"],
+    check=lambda d: (
+        assert_true(pdata(d)["pagination"]["has_more"]),
+        assert_true(any("truncated" in w.lower() for w in d.get("agent_hints", {}).get("warnings", []))),
+    ))
+
+run_cmd("5.3 error self-correction (wrong column)",
+    ["query", f"SELECT nonexistent_col FROM {TABLE} LIMIT 5", "--force", "--json"],
+    expect_code=None,  # SQL_ERROR(1) or other
+    check=lambda d: (
+        assert_true(d["status"] == "failure"),
+        assert_key(d.get("data", {}), "schema_context"),
+    ))
+
+
+# ===========================================================
+print("\n=== 6. Job ===")
+# ===========================================================
+_, jsubmit = run_cmd("6.1 job submit", ["job", "submit", "SELECT 1 AS job_test", "--json", "--force"],
+    check=lambda d: assert_key(pdata(d), "job_id"))
+JOB_ID = pdata(jsubmit).get("job_id")
+if JOB_ID:
+    print(f"       job_id: {JOB_ID}")
+
+    run_cmd("6.2 job status", ["job", "status", JOB_ID, "--json"],
+        check=lambda d: assert_key(pdata(d).get("job", {}), "stage"))
+
+    run_cmd("6.3 job wait", ["job", "wait", JOB_ID, "--json"],
+        check=lambda d: assert_true(d["status"] in ("success", "failure")))
+
+    run_cmd("6.4 job result", ["job", "result", JOB_ID, "--json"],
+        check=lambda d: assert_key(pdata(d).get("result", {}), "rows"))
+
+    run_cmd("6.5 job diagnose", ["job", "diagnose", JOB_ID, "--json"],
+        check=lambda d: assert_key(pdata(d).get("diagnosis", {}), "diagnosis_category"))
+else:
+    for label in ["6.2 job status", "6.3 job wait", "6.4 job result", "6.5 job diagnose"]:
+        RESULTS.append((label, "SKIP", "no job_id"))
+
+run_cmd("6.6 job list", ["job", "list", "--json"],
+    check=lambda d: assert_type(pdata(d).get("jobs", None), list))
+
+
+# ===========================================================
+print("\n=== 7. Data ===")
+# ===========================================================
+run_cmd("7.1 data sample", ["data", "sample", TABLE, "--rows", "3", "--json"],
+    expect_code=None,  # may fail if table is partitioned
+    check=lambda d: assert_true(d["status"] in ("success", "failure")))
+
+run_cmd("7.2 data profile", ["data", "profile", TABLE, "--json"],
+    expect_code=None,  # may fail if table is partitioned
+    check=lambda d: assert_true(d["status"] in ("success", "failure")))
+
+
+# ===========================================================
+print("\n=== 8. Diff ===")
+# ===========================================================
+run_cmd("8.1 diff schema self", ["diff", "schema", TABLE, TABLE, "--json"],
+    check=lambda d: assert_eq(pdata(d)["diff"]["compatible"], True))
+
+run_cmd("8.2 diff partition self", ["diff", "partition", TABLE, TABLE, "--json"],
+    check=lambda d: assert_key(pdata(d)["diff"], "summary"))
+
+run_cmd("8.3 diff data self", ["diff", "data", TABLE, TABLE, "--keys", TABLE_COL, "--rows", "5", "--json"],
+    expect_code=None,  # may fail if table is partitioned
+    check=lambda d: assert_true(d["status"] in ("success", "failure")))
+
+
+# ===========================================================
+print("\n=== 9. Session ===")
+# ===========================================================
+run_cmd("9.1 session show", ["session", "show", "--json"],
+    check=lambda d: assert_key(pdata(d), "project"))
+
+run_cmd("9.2 session set", ["session", "set", "--project", "meta_dev", "--json"],
+    check=lambda d: assert_eq(d["status"], "success"))
+
+run_cmd("9.3 session unset", ["session", "unset", "--json"],
+    check=lambda d: assert_eq(d["status"], "success"))
+
+
+# ===========================================================
+print("\n=== 10. Agent ===")
+# ===========================================================
+run_cmd("10.1 agent context", ["agent", "context", "--json"],
+    check=lambda d: assert_key(pdata(d).get("context", {}), "project"))
+
+run_cmd("10.2 agent skill", ["agent", "skill", "--json"],
+    check=lambda d: assert_eq(d["status"], "success"))
+
+
+# ===========================================================
+print("\n=== 11. Cache ===")
+# ===========================================================
+run_cmd("11.1 cache status", ["cache", "status", "--json"],
+    check=lambda d: assert_key(pdata(d), "table_count"))
+
+run_cmd("11.2 cache clear", ["cache", "clear", "--json"],
+    check=lambda d: assert_key(pdata(d), "deleted_tables"))
+
+run_cmd("11.3 cache build", ["cache", "build", "--json"],
+    check=lambda d: assert_key(pdata(d), "cached_tables"))
+
+run_cmd("11.4 cache build-status", ["cache", "build-status", "--json"],
+    check=lambda d: assert_eq(d["status"], "success"))
+
+
+# ===========================================================
+# SUMMARY
+# ===========================================================
+print("\n" + "=" * 60)
+print("REGRESSION TEST SUMMARY")
+print("=" * 60)
+passed = sum(1 for _, s, _ in RESULTS if s == "PASS")
+failed = sum(1 for _, s, _ in RESULTS if s == "FAIL")
+skipped = sum(1 for _, s, _ in RESULTS if s == "SKIP")
+
+if failed:
+    print(f"\nFAILED ({failed}):")
+    for label, status, detail in RESULTS:
+        if status == "FAIL":
+            print(f"  - {label}: {detail}")
+
+print(f"\nTotal: {passed} passed, {failed} failed, {skipped} skipped / {len(RESULTS)} tests")
+print("=" * 60)
+sys.exit(1 if failed else 0)

{maxc_cli-0.1.2 → maxc_cli-0.1.4}/setup.py

@@ -9,7 +9,7 @@ README = ROOT / "README.md"
 
 setup(
     name="maxc-cli",
-    version="0.1.2",
+    version="0.1.4",
     description="Agent-native MaxCompute CLI for external coding agents",
     long_description=README.read_text(encoding="utf-8"),
     long_description_content_type="text/markdown",
@@ -17,6 +17,13 @@ setup(
     package_dir={"": "src"},
     packages=find_packages(where="src"),
     include_package_data=True,
+    package_data={
+        "maxc_cli": [
+            "skills/SKILL.md",
+            "skills/references/*.md",
+            "skills/agents/*.yaml",
+        ],
+    },
     classifiers=[
         "Programming Language :: Python :: 3",
         "Programming Language :: Python :: 3.8",

{maxc_cli-0.1.2 → maxc_cli-0.1.4}/src/maxc_cli/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.2"
+__version__ = "0.1.4"