gravity-insight 0.3.1__tar.gz

gravity_insight-0.3.1/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: gravity-insight
+Version: 0.3.1
+Summary: Agent-first governed data-analysis runtime, Python SDK, and CLI for Gravity
+Author: mmm1h
+Maintainer: mmm1h
+Project-URL: Repository, https://github.com/mmm1h/gravity-sdk
+Project-URL: Issues, https://github.com/mmm1h/gravity-sdk/issues
+Keywords: analytics,cli,governance,gravity,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: requests==2.33.0
+Requires-Dist: sqlglot==30.17.0
+Requires-Dist: tzdata==2026.3
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=9; extra == "dev"
+
+# Gravity SDK
+
+Gravity Agent Runtime 的实现仓库，当前稳定内核是面向数据分析团队的 Agent-first Python SDK 与 CLI。仓库把 Gravity 的发现、读取、导出和受治理写入收敛为版本化合同，并按已批准路线扩展版本化 Skill、业务语义、确定性分析方法和有界 Context，让分析任务无需打开 Gravity Web 也能完成。
+
+## 从这里开始
+
+- **使用 SDK 取数或分析**：读 [团队上手包](docs/team-onboarding.md)，然后运行：
+
+  ```powershell
+  $env:PYTHONPATH='src'
+  python -m gravity_sdk agent-catalog categories
+  ```
+
+- **修改本仓库**：先读 [AGENTS.md](AGENTS.md)，再从 [维护者入口](docs/maintainers/index.md) 选择当前任务。
+
+## 产品入口
+
+- `gravity insight`：受合同治理的 Insight 查询与导出，日常分析首选。
+- `gravity sql`：仅执行 workspace 已登记的 SQL 产品，不接受任意 SQL。
+- `gravity census`：盘点前端路由、发现候选合同并检查上游漂移。
+- `gravity agent-catalog` / `gravity agent` / `gravity plan`：供 Agent 渐进发现、补参和显式执行。
+
+自然语言不会自动执行写入。所有 mutation 先预览，再由调用方用同一输入显式确认执行。
+
+## Agent Runtime 演进计划
+
+当前可执行能力仍以上述 CLI、SDK、Plan、运行时 catalog 和机器合同为准；目标架构不等于已经交付。批准的 Gravity Agent Runtime 改造已拆成版本化[需求索引](specs/agent-runtime/index.md)，每个单元独立验收并集成到 `dev`。
+
+本计划完整完成前不把其中的功能开发合入 `main`。Skill Hub、Context、Operator/Model、MCP、SQL Explorer 等只有在对应需求达到 `ready` 并实际落地后，才会进入当前能力文档和公共接口承诺。
+
+## 安装
+
+```powershell
+python -m pip install -e .
+gravity --help
+gravity agent-catalog categories
+```
+
+Python 最小入口：
+
+```python
+from gravity_sdk import connect
+
+gravity = connect()
+result = gravity.read("app.list", {"page": 1, "page_size": 20})
+```
+
+## 文档
+
+[文档导航](docs/index.md)按任务给出最短阅读路径。接口签名以 [CLI](docs/reference/cli.md)、[SDK](docs/reference/sdk.md) 和 [Plan](docs/reference/plan.md) 参考为准；当前能力以本机 `agent-catalog` 与合同编译结果为准，完整目标以 [canonical architecture source](specs/agent-runtime/architecture-source.md) 为准，交付顺序由批准 directive 与[需求索引](specs/agent-runtime/index.md)约束。
+
+历史拆仓来源见 [MIGRATION.md](MIGRATION.md)。

gravity_insight-0.3.1/README.md

@@ -0,0 +1,52 @@
+# Gravity SDK
+
+Gravity Agent Runtime 的实现仓库，当前稳定内核是面向数据分析团队的 Agent-first Python SDK 与 CLI。仓库把 Gravity 的发现、读取、导出和受治理写入收敛为版本化合同，并按已批准路线扩展版本化 Skill、业务语义、确定性分析方法和有界 Context，让分析任务无需打开 Gravity Web 也能完成。
+
+## 从这里开始
+
+- **使用 SDK 取数或分析**：读 [团队上手包](docs/team-onboarding.md)，然后运行：
+
+  ```powershell
+  $env:PYTHONPATH='src'
+  python -m gravity_sdk agent-catalog categories
+  ```
+
+- **修改本仓库**：先读 [AGENTS.md](AGENTS.md)，再从 [维护者入口](docs/maintainers/index.md) 选择当前任务。
+
+## 产品入口
+
+- `gravity insight`：受合同治理的 Insight 查询与导出，日常分析首选。
+- `gravity sql`：仅执行 workspace 已登记的 SQL 产品，不接受任意 SQL。
+- `gravity census`：盘点前端路由、发现候选合同并检查上游漂移。
+- `gravity agent-catalog` / `gravity agent` / `gravity plan`：供 Agent 渐进发现、补参和显式执行。
+
+自然语言不会自动执行写入。所有 mutation 先预览，再由调用方用同一输入显式确认执行。
+
+## Agent Runtime 演进计划
+
+当前可执行能力仍以上述 CLI、SDK、Plan、运行时 catalog 和机器合同为准；目标架构不等于已经交付。批准的 Gravity Agent Runtime 改造已拆成版本化[需求索引](specs/agent-runtime/index.md)，每个单元独立验收并集成到 `dev`。
+
+本计划完整完成前不把其中的功能开发合入 `main`。Skill Hub、Context、Operator/Model、MCP、SQL Explorer 等只有在对应需求达到 `ready` 并实际落地后，才会进入当前能力文档和公共接口承诺。
+
+## 安装
+
+```powershell
+python -m pip install -e .
+gravity --help
+gravity agent-catalog categories
+```
+
+Python 最小入口：
+
+```python
+from gravity_sdk import connect
+
+gravity = connect()
+result = gravity.read("app.list", {"page": 1, "page_size": 20})
+```
+
+## 文档
+
+[文档导航](docs/index.md)按任务给出最短阅读路径。接口签名以 [CLI](docs/reference/cli.md)、[SDK](docs/reference/sdk.md) 和 [Plan](docs/reference/plan.md) 参考为准；当前能力以本机 `agent-catalog` 与合同编译结果为准，完整目标以 [canonical architecture source](specs/agent-runtime/architecture-source.md) 为准，交付顺序由批准 directive 与[需求索引](specs/agent-runtime/index.md)约束。
+
+历史拆仓来源见 [MIGRATION.md](MIGRATION.md)。

gravity_insight-0.3.1/pyproject.toml

@@ -0,0 +1,152 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gravity-insight"
+version = "0.3.1"
+description = "Agent-first governed data-analysis runtime, Python SDK, and CLI for Gravity"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{name = "mmm1h"}]
+maintainers = [{name = "mmm1h"}]
+keywords = ["analytics", "cli", "governance", "gravity", "sdk"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+  "requests==2.33.0",
+  "sqlglot==30.17.0",
+  "tzdata==2026.3",
+]
+
+[project.urls]
+Repository = "https://github.com/mmm1h/gravity-sdk"
+Issues = "https://github.com/mmm1h/gravity-sdk/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=9,<10"]
+
+[project.scripts]
+gravity = "gravity_sdk.__main__:main"
+gravity-insight = "gravity_sdk.cli_stdio:insight_main"
+gravity-sql = "gravity_sdk.cli_stdio:sql_main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["gravity_sdk*"]
+
+[tool.setuptools.package-data]
+gravity_sdk = [
+  "contracts/**/*.json",
+  "skills/**/*.md",
+  "skills/**/*.json",
+  "manifests/*.json",
+  "census/data/*",
+  "governance/*.json",
+]
+
+[tool.gravity_sdk.agent-package-membership]
+schema-version = 1
+members = [
+  "advertiser_profile.py",
+  "analysis.py",
+  "analysis_default_dictionary.py",
+  "analysis_task.py",
+  "app_catalog.py",
+  "app_public_info.py",
+  "attribution_performance.py",
+  "attribution_user_detail.py",
+  "batch.py",
+  "batch_questions.py",
+  "batch_sources.py",
+  "bilibili_account_performance.py",
+  "business_pulse.py",
+  "call_bound.py",
+  "caller_language.py",
+  "capabilities.py",
+  "catalog.py",
+  "catalog_parity.py",
+  "catalog_refresh.py",
+  "client.py",
+  "company_usage.py",
+  "composite.py",
+  "composite_inventory.py",
+  "custom_audience.py",
+  "custom_metric.py",
+  "dashboard.py",
+  "derived_metrics.py",
+  "discovery_policy.py",
+  "discovery_support.py",
+  "export.py",
+  "fixed_snapshots.py",
+  "gap.py",
+  "handoff.py",
+  "host_catalog.py",
+  "host_selection.py",
+  "input_catalogs.py",
+  "input_resolution.py",
+  "intent_routing.py",
+  "intent_text.py",
+  "kanban_mutation.py",
+  "lexical_rescue.py",
+  "lexical_retrieval.py",
+  "material_asset.py",
+  "material_performance.py",
+  "metadata_onboarding.py",
+  "metadata_search.py",
+  "metadata_template.py",
+  "monetization_aggregate.py",
+  "monetization_guard.py",
+  "multidim.py",
+  "mutation_cards.py",
+  "operation_contract.py",
+  "order_directory.py",
+  "order_trace.py",
+  "output.py",
+  "product_inventory.py",
+  "promotion_performance.py",
+  "realtime_event.py",
+  "realtime_event_catalog.py",
+  "relative_date.py",
+  "report_directory.py",
+  "report_mutation.py",
+  "report_routing.py",
+  "saved_analysis.py",
+  "saved_analysis_mutation.py",
+  "segment.py",
+  "segment_members.py",
+  "segment_snapshot.py",
+  "semantic_compose.py",
+  "semantic_context.py",
+  "semantic_derived.py",
+  "sources.py",
+  "sql_product_discovery.py",
+  "sql_product_gap.py",
+  "table_lineage.py",
+  "title_package.py",
+  "unavailable.py",
+  "unavailable_analysis.py",
+  "unavailable_promotion.py",
+  "unavailable_report.py",
+  "user_journey.py",
+  "vocabulary.py",
+]
+
+[tool.ruff.lint]
+select = ["F"]
+
+[tool.pytest.ini_options]
+# Transient codex worktrees live at the repository root and duplicate every
+# tests/ basename, which breaks pytest collection with import file mismatch.
+norecursedirs = ["_wt_*", ".venv", "build", "dist", "tmp"]

gravity_insight-0.3.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

gravity_insight-0.3.1/src/gravity_insight.egg-info/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: gravity-insight
+Version: 0.3.1
+Summary: Agent-first governed data-analysis runtime, Python SDK, and CLI for Gravity
+Author: mmm1h
+Maintainer: mmm1h
+Project-URL: Repository, https://github.com/mmm1h/gravity-sdk
+Project-URL: Issues, https://github.com/mmm1h/gravity-sdk/issues
+Keywords: analytics,cli,governance,gravity,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: requests==2.33.0
+Requires-Dist: sqlglot==30.17.0
+Requires-Dist: tzdata==2026.3
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=9; extra == "dev"
+
+# Gravity SDK
+
+Gravity Agent Runtime 的实现仓库，当前稳定内核是面向数据分析团队的 Agent-first Python SDK 与 CLI。仓库把 Gravity 的发现、读取、导出和受治理写入收敛为版本化合同，并按已批准路线扩展版本化 Skill、业务语义、确定性分析方法和有界 Context，让分析任务无需打开 Gravity Web 也能完成。
+
+## 从这里开始
+
+- **使用 SDK 取数或分析**：读 [团队上手包](docs/team-onboarding.md)，然后运行：
+
+  ```powershell
+  $env:PYTHONPATH='src'
+  python -m gravity_sdk agent-catalog categories
+  ```
+
+- **修改本仓库**：先读 [AGENTS.md](AGENTS.md)，再从 [维护者入口](docs/maintainers/index.md) 选择当前任务。
+
+## 产品入口
+
+- `gravity insight`：受合同治理的 Insight 查询与导出，日常分析首选。
+- `gravity sql`：仅执行 workspace 已登记的 SQL 产品，不接受任意 SQL。
+- `gravity census`：盘点前端路由、发现候选合同并检查上游漂移。
+- `gravity agent-catalog` / `gravity agent` / `gravity plan`：供 Agent 渐进发现、补参和显式执行。
+
+自然语言不会自动执行写入。所有 mutation 先预览，再由调用方用同一输入显式确认执行。
+
+## Agent Runtime 演进计划
+
+当前可执行能力仍以上述 CLI、SDK、Plan、运行时 catalog 和机器合同为准；目标架构不等于已经交付。批准的 Gravity Agent Runtime 改造已拆成版本化[需求索引](specs/agent-runtime/index.md)，每个单元独立验收并集成到 `dev`。
+
+本计划完整完成前不把其中的功能开发合入 `main`。Skill Hub、Context、Operator/Model、MCP、SQL Explorer 等只有在对应需求达到 `ready` 并实际落地后，才会进入当前能力文档和公共接口承诺。
+
+## 安装
+
+```powershell
+python -m pip install -e .
+gravity --help
+gravity agent-catalog categories
+```
+
+Python 最小入口：
+
+```python
+from gravity_sdk import connect
+
+gravity = connect()
+result = gravity.read("app.list", {"page": 1, "page_size": 20})
+```
+
+## 文档
+
+[文档导航](docs/index.md)按任务给出最短阅读路径。接口签名以 [CLI](docs/reference/cli.md)、[SDK](docs/reference/sdk.md) 和 [Plan](docs/reference/plan.md) 参考为准；当前能力以本机 `agent-catalog` 与合同编译结果为准，完整目标以 [canonical architecture source](specs/agent-runtime/architecture-source.md) 为准，交付顺序由批准 directive 与[需求索引](specs/agent-runtime/index.md)约束。
+
+历史拆仓来源见 [MIGRATION.md](MIGRATION.md)。