maxc-cli 0.1.5__tar.gz → 0.1.7__tar.gz

{maxc_cli-0.1.5 → maxc_cli-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxc-cli
-Version: 0.1.5
+Version: 0.1.7
 Summary: Agent-native MaxCompute CLI for external coding agents
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
@@ -8,7 +8,9 @@ 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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: PyYAML>=5.4
 Requires-Dist: pyodps

{maxc_cli-0.1.5 → maxc_cli-0.1.7}/setup.py

@@ -9,11 +9,11 @@ README = ROOT / "README.md"
 
 setup(
     name="maxc-cli",
-    version="0.1.5",
+    version="0.1.7",
     description="Agent-native MaxCompute CLI for external coding agents",
     long_description=README.read_text(encoding="utf-8"),
     long_description_content_type="text/markdown",
-    python_requires=">=3.8,<3.13",
+    python_requires=">=3.8",
     package_dir={"": "src"},
     packages=find_packages(where="src"),
     include_package_data=True,
@@ -31,6 +31,8 @@ setup(
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
     ],
     install_requires=[
         "PyYAML>=5.4",

{maxc_cli-0.1.5 → maxc_cli-0.1.7}/src/maxc_cli/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.5"
+__version__ = "0.1.7"

{maxc_cli-0.1.5 → maxc_cli-0.1.7}/src/maxc_cli/backend/query.py

@@ -115,10 +115,17 @@ class QueryMixin:
             instance = self.client.execute_sql(
                 actual_sql, project=project, hints=hints,
             )
+        except Exception as exc:
+            raise translate_odps_error(exc) from exc
+
+        try:
             # Default timeout: 300 seconds (5 minutes) to prevent indefinite blocking
             instance.wait_for_success(timeout=timeout or 300)
         except Exception as exc:
-            raise translate_odps_error(exc) from exc
+            err = translate_odps_error(exc)
+            err.instance_id = instance.id
+            err.logview = self._safe_logview(instance)
+            raise err from exc
 
         elapsed_ms = int((monotonic() - started_monotonic) * 1000)
         result = self._instance_to_query_result(

{maxc_cli-0.1.5 → maxc_cli-0.1.7}/src/maxc_cli/cli.py

@@ -512,6 +512,7 @@ def run(
             "BACKEND_CONNECTION_ERROR": _AUTH_HINTS,
             "PERMISSION_DENIED": AgentHints(
                 actions=[action("auth.can-i"), action("auth.whoami")],
+                insights=[f"Current project: {app.config.default_project}"] if app else [],
             ),
             "NOT_FOUND": AgentHints(
                 actions=[action("meta.search"), action("meta.list-tables")],
@@ -572,6 +573,10 @@ def run(
             emit_json(payload.to_dict(), stdout)
         else:
             stderr.write(render_error(exc.error_code, exc.message, exc.suggestion) + "\n")
+            if getattr(exc, "instance_id", None):
+                stderr.write(f"  Instance ID: {exc.instance_id}\n")
+            if getattr(exc, "logview", None):
+                stderr.write(f"  LogView: {exc.logview}\n")
         return exc.exit_code
     except Exception as exc:
         error_payload = ErrorPayload(

{maxc_cli-0.1.5 → maxc_cli-0.1.7}/src/maxc_cli/exceptions.py

@@ -10,6 +10,8 @@ class ErrorPayload:
     suggestion: 'str | None'
     recoverable: 'bool'
     recovery_steps: 'list[str]' = field(default_factory=list)
+    instance_id: 'str | None' = None
+    logview: 'str | None' = None
 
     def to_dict(self) -> 'dict[str, Any]':
         payload: 'dict[str, Any]' = {
@@ -21,6 +23,10 @@ class ErrorPayload:
             payload["suggestion"] = self.suggestion
         if self.recovery_steps:
             payload["recovery_steps"] = self.recovery_steps
+        if self.instance_id:
+            payload["instance_id"] = self.instance_id
+        if self.logview:
+            payload["logview"] = self.logview
         return payload
 
 
@@ -35,10 +41,14 @@ class MaxCError(Exception):
         *,
         suggestion: 'str | None' = None,
         recoverable: 'bool | None' = None,
+        instance_id: 'str | None' = None,
+        logview: 'str | None' = None,
     ) -> 'None':
         super().__init__(message)
         self.message = message
         self.suggestion = suggestion
+        self.instance_id = instance_id
+        self.logview = logview
         if recoverable is None:
             self.recoverable = self.__class__.recoverable
         else:
@@ -52,6 +62,8 @@ class MaxCError(Exception):
             suggestion=self.suggestion,
             recoverable=self.recoverable,
             recovery_steps=steps,
+            instance_id=self.instance_id,
+            logview=self.logview,
         )
 
     def _default_recovery_steps(self) -> 'list[str]':

{maxc_cli-0.1.5 → maxc_cli-0.1.7}/src/maxc_cli/skills/SKILL.md

@@ -93,7 +93,6 @@ See [references/migrate-from-odpscmd.md](references/migrate-from-odpscmd.md) for
 - Trust runtime help and actual command output over stale snippets.
 - Never install or upgrade Python without explicit user confirmation.
 - Prefer `auth login` over hand-editing `~/.maxc/config.yaml`.
-- `meta list-tables` is cache-backed; falls back to live backend query on cache miss.
 - `meta search` uses Catalog API (server-side FTS via pyodps RestClient) when auto-routed; falls back to cache-backed substring match, then live scan. No extra SDK dependency required.
 - Most meta commands support `--schema` to override the session default (list-tables, search, search-columns).
 - `session set/show/unset` are local-only — no authenticated backend required.
@@ -101,11 +100,9 @@ See [references/migrate-from-odpscmd.md](references/migrate-from-odpscmd.md) for
 - `agent skill` returns the SKILL.md path and metadata.
 - `agent install-skill <platform>` registers the skill with an Agent platform (claude-code, cursor, windsurf, codex, qwen, qoder, qoderwork). Idempotent; re-run after `pip install --upgrade` to update local skill files.
 - Use normalized `data` shapes: `auth whoami` → `data.identity`, `query`/`job result` → `data.result`, `meta describe` → `data.table`, `data sample` → `data.sample`.
-- Use `agent_hints.actions[]` for structured action objects (Phase 1+); `action_ids` and `next_actions` are derived from `actions[]` and remain available for backward compatibility.
-- Use `agent_hints.action_ids` for stable program logic; `next_actions` are hints only.
+- Use `agent_hints.actions[]` for structured navigation. Each action has `id`, `title`, `command`. Use `actions[].id` for stable program logic. Do not execute `next_actions` strings directly — they may have broken shell quoting; construct commands yourself from the action `id` and context.
 - Before exploring an unfamiliar project, ask the user which schema/table they need — do not iterate all schemas.
 - When a query fails with `SQL_ERROR`, read `error.suggestion` before retrying. Do not retry the same SQL unchanged.
-- `next_actions` commands may have broken shell quoting when SQL contains single quotes. Use `actions[].id` to identify the action, then construct the command yourself if needed.
 - For partitioned tables, always determine the partition value via `meta latest-partition` or `meta partitions` before querying.
 - When writing SQL for date-partitioned tables, use the exact partition format returned by `meta latest-partition` (format varies by table).
 
@@ -284,15 +281,12 @@ See [references/maxcompute-sql-notes.md](references/maxcompute-sql-notes.md) for
 | Using `maxc sql ...` | The command is `maxc query ...` |
 | Using `auth login --from-env` without checking env vars exist | Run `auth whoami --json` first; only use `--from-env` when env vars are confirmed set |
 | Hand-editing `~/.maxc/config.yaml` | Use `auth login` |
-| Calling `meta list-tables` on a cold cache | Tables are fetched live on cache miss; `cache build` improves speed for repeat queries |
 | Inventing endpoints | Only use endpoints the user provided or that exist in current config |
 | Using `job wait --stream` and expecting a JSON envelope | `--stream` emits NDJSON; use plain `job wait --json` for envelope |
 | Running a query without checking cost first | Use `query cost` before large queries; use `--cost-check` to set auto-abort threshold |
 | Ignoring `agent_hints.warnings` in the response | Always check warnings — they surface backend issues, cache staleness, and cost alerts |
 | Assuming `meta describe` data is live | Cache source may be stale; check `metadata.source` field and `agent_hints.warnings` |
-| Querying partitioned table without WHERE on partition column | Use `meta partitions` or `meta latest-partition` to get partition value first |
-| Using `MAX_PT()` in ad-hoc queries | Prefer literal values from `meta latest-partition`; MAX_PT may return incomplete partitions |
-| Hardcoding partition dates like `ds = '20260101'` | Use `meta latest-partition` to get the actual latest value |
+| Querying partitioned table without partition filter, or hardcoding/guessing partition values | Always run `meta latest-partition` first; use the exact returned value in WHERE (see Partition Query Strategy) |
 | Assuming 2-tier naming (`project.table`) | Check if project uses 3-tier namespace with `meta list-schemas` |
 
 ## Agent Anti-Patterns
@@ -303,7 +297,6 @@ See [references/maxcompute-sql-notes.md](references/maxcompute-sql-notes.md) for
 | Retrying the exact same failed SQL without changes | Same input → same error | Read `error.suggestion`, fix the SQL, then retry |
 | Using `SELECT *` on unknown tables | May scan TB of data, hit cost limits | Use `meta describe` first, then select only needed columns with LIMIT |
 | Generating SQL without checking column names first | Column names are often non-obvious (Chinese, abbreviated) | Always `meta describe` before writing SQL |
-| Assuming partition format (e.g. `YYYY-MM-DD`) | Format varies by table (`20260415` vs `2026-04-15`) | Use `meta latest-partition` to get exact format |
 | Running multiple queries when one suffices | Wastes compute and time | Combine into a single query with JOINs or subqueries |
 
 ## Error Recovery

{maxc_cli-0.1.5 → maxc_cli-0.1.7}/src/maxc_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxc-cli
-Version: 0.1.5
+Version: 0.1.7
 Summary: Agent-native MaxCompute CLI for external coding agents
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
@@ -8,7 +8,9 @@ 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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: PyYAML>=5.4
 Requires-Dist: pyodps