gridzen-developer-kit 0.3.0__tar.gz → 0.4.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/MANIFEST.in +4 -0
  2. {gridzen_developer_kit-0.3.0/src/gridzen_developer_kit.egg-info → gridzen_developer_kit-0.4.1}/PKG-INFO +23 -8
  3. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/README.es.md +19 -3
  4. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/README.md +22 -7
  5. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/README.zh-CN.md +19 -3
  6. gridzen_developer_kit-0.4.1/clients/claude-code.json +8 -0
  7. gridzen_developer_kit-0.4.1/clients/claude-desktop.json +8 -0
  8. gridzen_developer_kit-0.4.1/clients/cline.json +10 -0
  9. gridzen_developer_kit-0.4.1/clients/codex.toml +2 -0
  10. gridzen_developer_kit-0.4.1/clients/compatibility.json +181 -0
  11. gridzen_developer_kit-0.4.1/clients/copilot-cli.json +11 -0
  12. gridzen_developer_kit-0.4.1/clients/cursor.json +7 -0
  13. gridzen_developer_kit-0.4.1/clients/gemini-cli.json +7 -0
  14. gridzen_developer_kit-0.4.1/clients/opencode.json +10 -0
  15. gridzen_developer_kit-0.4.1/clients/roo-code.json +8 -0
  16. gridzen_developer_kit-0.4.1/clients/vscode.json +8 -0
  17. gridzen_developer_kit-0.4.1/docs/harness/README.md +18 -0
  18. gridzen_developer_kit-0.4.1/docs/harness/claude-code.md +36 -0
  19. gridzen_developer_kit-0.4.1/docs/harness/claude-desktop.md +36 -0
  20. gridzen_developer_kit-0.4.1/docs/harness/cline.md +36 -0
  21. gridzen_developer_kit-0.4.1/docs/harness/codex.md +36 -0
  22. gridzen_developer_kit-0.4.1/docs/harness/copilot-cli.md +46 -0
  23. gridzen_developer_kit-0.4.1/docs/harness/cursor.md +36 -0
  24. gridzen_developer_kit-0.4.1/docs/harness/gemini-cli.md +36 -0
  25. gridzen_developer_kit-0.4.1/docs/harness/opencode.md +36 -0
  26. gridzen_developer_kit-0.4.1/docs/harness/roo-code.md +36 -0
  27. gridzen_developer_kit-0.4.1/docs/harness/vscode.md +36 -0
  28. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/pyproject.toml +2 -2
  29. gridzen_developer_kit-0.4.1/scripts/check_integration.py +61 -0
  30. gridzen_developer_kit-0.4.1/skills/gridzen-integrate-sandbox/SKILL.md +14 -0
  31. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/gridzen-integrate-sandbox/references/api.md +1 -1
  32. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/__init__.py +1 -1
  33. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/cli.py +8 -0
  34. gridzen_developer_kit-0.4.1/src/gridzen_developer/data/LICENSE +21 -0
  35. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/mcp.py +1 -1
  36. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/server.py +3 -3
  37. gridzen_developer_kit-0.4.1/src/gridzen_developer/setup.py +133 -0
  38. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/client-configs.json +12 -0
  39. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/compatibility.json +181 -0
  40. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/developer.css +9 -0
  41. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/web/developer.js +1 -1
  42. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/harnesses.html +3 -0
  43. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/harnesses.js +2 -0
  44. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/index.html +7 -0
  45. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/layout.js +47 -0
  46. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/web/locales.js +168 -58
  47. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/privacy.html +1 -0
  48. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/quickstart.html +14 -0
  49. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/site-shell.json +17 -0
  50. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/support.html +1 -0
  51. gridzen_developer_kit-0.4.1/src/gridzen_developer/web/terms.html +1 -0
  52. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1/src/gridzen_developer_kit.egg-info}/PKG-INFO +23 -8
  53. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer_kit.egg-info/SOURCES.txt +33 -0
  54. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/tests/test_localization.py +2 -2
  55. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/tests/test_remote.py +1 -1
  56. gridzen_developer_kit-0.4.1/tests/test_setup.py +65 -0
  57. gridzen_developer_kit-0.4.1/tests/test_site_shell.py +31 -0
  58. gridzen_developer_kit-0.3.0/skills/gridzen-integrate-sandbox/SKILL.md +0 -12
  59. gridzen_developer_kit-0.3.0/src/gridzen_developer/web/developer.css +0 -2
  60. gridzen_developer_kit-0.3.0/src/gridzen_developer/web/index.html +0 -3
  61. gridzen_developer_kit-0.3.0/src/gridzen_developer/web/privacy.html +0 -1
  62. gridzen_developer_kit-0.3.0/src/gridzen_developer/web/quickstart.html +0 -14
  63. gridzen_developer_kit-0.3.0/src/gridzen_developer/web/support.html +0 -1
  64. gridzen_developer_kit-0.3.0/src/gridzen_developer/web/terms.html +0 -1
  65. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/LICENSE +0 -0
  66. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/NOTICE.md +0 -0
  67. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/setup.cfg +0 -0
  68. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/gridzen-explain-verification/SKILL.md +0 -0
  69. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/gridzen-select-verification/SKILL.md +0 -0
  70. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/LICENSE +0 -0
  71. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/README.md +0 -0
  72. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/SKILL.md +0 -0
  73. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/agent-evals.json +0 -0
  74. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/evaluate.py +0 -0
  75. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/example-input.json +0 -0
  76. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/examples/missing-evidence.json +0 -0
  77. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/examples/normal.json +0 -0
  78. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/examples/out-of-scope.json +0 -0
  79. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/spec.json +0 -0
  80. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/mexico-pilot-scoper/test_evaluate.py +0 -0
  81. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/LICENSE +0 -0
  82. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/README.md +0 -0
  83. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/SKILL.md +0 -0
  84. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/agent-evals.json +0 -0
  85. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/evaluate.py +0 -0
  86. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/example-input.json +0 -0
  87. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/examples/missing-evidence.json +0 -0
  88. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/examples/normal.json +0 -0
  89. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/examples/out-of-scope.json +0 -0
  90. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/spec.json +0 -0
  91. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/payout-policy-designer/test_evaluate.py +0 -0
  92. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/LICENSE +0 -0
  93. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/README.md +0 -0
  94. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/SKILL.md +0 -0
  95. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/agent-evals.json +0 -0
  96. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/evaluate.py +0 -0
  97. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/example-input.json +0 -0
  98. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/examples/missing-evidence.json +0 -0
  99. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/examples/normal.json +0 -0
  100. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/examples/out-of-scope.json +0 -0
  101. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/spec.json +0 -0
  102. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/skills/provider-rights-readiness/test_evaluate.py +0 -0
  103. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/client.py +0 -0
  104. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/core.py +0 -0
  105. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/data/catalog.json +0 -0
  106. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/remote.py +0 -0
  107. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/skills.py +0 -0
  108. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/usage.py +0 -0
  109. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/web/icon.png +0 -0
  110. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/web/icon.svg +0 -0
  111. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer/web/language.js +0 -0
  112. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer_kit.egg-info/dependency_links.txt +0 -0
  113. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer_kit.egg-info/entry_points.txt +0 -0
  114. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer_kit.egg-info/requires.txt +0 -0
  115. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/src/gridzen_developer_kit.egg-info/top_level.txt +0 -0
  116. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/tests/test_developer.py +0 -0
  117. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/tests/test_usage.py +0 -0
  118. {gridzen_developer_kit-0.3.0 → gridzen_developer_kit-0.4.1}/tests/test_workflow_skills.py +0 -0
@@ -4,3 +4,7 @@ prune dist
4
4
  prune build
5
5
  global-exclude *.py[cod] *.pem .env .env.*
6
6
  recursive-include skills *.md *.json *.py LICENSE
7
+
8
+ recursive-include clients *.json *.toml
9
+ recursive-include docs/harness *.md
10
+ include scripts/check_integration.py
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: gridzen-developer-kit
3
- Version: 0.3.0
3
+ Version: 0.4.1
4
4
  Summary: Gridzen research catalog, integration planner and explicit verification sandbox
5
5
  Author-email: Gridzen <open@gridzen.ai>
6
6
  License-Expression: MIT
@@ -27,7 +27,7 @@ Requires-Dist: fastapi==0.142.4; extra == "test"
27
27
  Requires-Dist: uvicorn==0.54.0; extra == "test"
28
28
  Dynamic: license-file
29
29
 
30
- # Gridzen Developer Kit 0.3.0
30
+ # Gridzen Developer Kit 0.4.1
31
31
 
32
32
  Research for 198 countries/territories, a verification integration planner, five synthetic outcomes, an HTTP SDK, local MCP server and six Skills. **No live provider is enabled. No real person is verified.** The research snapshot is dated 2026-10-07, with source links and file hashes.
33
33
 
@@ -106,11 +106,12 @@ npx skills add immurray/gridzen-developer-kit
106
106
  Install the tagged Python/MCP release from GitHub (Python 3.11+ and Git):
107
107
 
108
108
  ```sh
109
- python -m pip install "gridzen-developer-kit[mcp] @ git+https://github.com/immurray/gridzen-developer-kit.git@v0.2.0"
109
+ python -m pip install "gridzen-developer-kit[mcp] @ git+https://github.com/immurray/gridzen-developer-kit.git@v0.4.1"
110
110
  ```
111
111
 
112
- A PyPI package is not published yet. Use the GitHub release or website download
113
- until the release tracker records a verified PyPI URL.
112
+ PyPI 0.4.1 is published and verified. Install with `python -m pip install
113
+ gridzen-developer-kit`. See [the release tracker](distribution/STATUS.md) for
114
+ publication and installation evidence.
114
115
 
115
116
  Remote client configuration (conventional JSON; client syntax may vary):
116
117
 
@@ -131,11 +132,13 @@ Original code and Skills: MIT. Research provenance and third-party rights:
131
132
  Source, release downloads, the official MCP Registry entry and six Skills.sh pages are public. Docker catalog submission is awaiting review. See [the publication ledger](distribution/STATUS.md) for exact status and remaining platform steps.
132
133
 
133
134
 
134
- ## Six bundled Skills (0.3.0)
135
+ ## Six bundled Skills (0.4.1)
135
136
 
136
137
  `python -m pip install gridzen-developer-kit` installs the CLI, stdio MCP dependencies
137
- and all six Skill directories. Once 0.3.0 is published, no extra MCP dependency
138
- installation is required. Until then, use the verified GitHub release wheel.
138
+ and all six Skill directories. Version 0.4.1 is published on
139
+ [PyPI](https://pypi.org/project/gridzen-developer-kit/0.4.1/); clean installation,
140
+ CLI, stdio MCP and all six bundled Skill directories were verified. No extra MCP
141
+ dependency installation is required.
139
142
 
140
143
  ```sh
141
144
  gridzen coverage --country MX
@@ -153,3 +156,15 @@ workflows, version 1.0.0: `mexico-pilot-scoper`, `payout-policy-designer`, and
153
156
  `provider-rights-readiness`. Each includes MIT, README, complete response fixtures
154
157
  and agent acceptance prompts. They make no third-party calls and grant no real
155
158
  verification, legal approval or regulatory conclusion.
159
+
160
+ ## Configure your assistant (v0.4.1)
161
+
162
+ ```sh
163
+ python3 -m venv .venv
164
+ . .venv/bin/activate
165
+ python -m pip install --upgrade gridzen-developer-kit
166
+ gridzen setup --client all --project .
167
+ gridzen setup --client all --project . --apply
168
+ ```
169
+
170
+ Use `--client` for Codex, Claude Code/Desktop, Cursor, VS Code/Copilot, Copilot CLI, Gemini CLI, Cline, Roo Code or OpenCode. Setup previews by default, merges existing unrelated settings, backs up changed configurations and refuses differing Gridzen entries or Skill files. No global client settings are modified. Native clients require workspace trust; Desktop and Cline require manual MCP import. Desktop produces six separately uploadable ZIPs. See [client-specific instructions](docs/harness/README.md) and [actual compatibility evidence](clients/compatibility.json). Configuration preparation is not model acceptance or real verification.
@@ -60,11 +60,13 @@ Código original bajo MIT; consulte NOTICE.md para los derechos de terceros.
60
60
  El código, las descargas, la entrada oficial de MCP Registry y tres páginas de Skills.sh están publicados. La propuesta del catálogo de Docker está pendiente de revisión. Consulta [el registro de publicación](distribution/STATUS.md).
61
61
 
62
62
 
63
- ## Six bundled Skills (0.3.0)
63
+ ## Six bundled Skills (0.4.1)
64
64
 
65
65
  `python -m pip install gridzen-developer-kit` installs the CLI, stdio MCP dependencies
66
- and all six Skill directories. Once 0.3.0 is published, no extra MCP dependency
67
- installation is required. Until then, use the verified GitHub release wheel.
66
+ and all six Skill directories. Version 0.4.1 is published on
67
+ [PyPI](https://pypi.org/project/gridzen-developer-kit/0.4.1/); clean installation,
68
+ CLI, stdio MCP and all six bundled Skill directories were verified. No extra MCP
69
+ dependency installation is required.
68
70
 
69
71
  ```sh
70
72
  gridzen coverage --country MX
@@ -82,3 +84,17 @@ workflows, version 1.0.0: `mexico-pilot-scoper`, `payout-policy-designer`, and
82
84
  `provider-rights-readiness`. Each includes MIT, README, complete response fixtures
83
85
  and agent acceptance prompts. They make no third-party calls and grant no real
84
86
  verification, legal approval or regulatory conclusion.
87
+
88
+ ## Configura diez clientes
89
+
90
+ ```sh
91
+ python3 -m venv .venv
92
+ . .venv/bin/activate
93
+ python -m pip install --upgrade gridzen-developer-kit
94
+ gridzen setup --client all --project .
95
+ gridzen setup --client all --project . --apply
96
+ ```
97
+
98
+ Usa Python 3.11+ en un entorno virtual. Primero revisa el resultado y después añade --apply. No cambia configuraciones globales. Desktop y Cline requieren importación manual; los demás necesitan confianza del proyecto. Configuración no equivale a aceptación del cliente o modelo.
99
+
100
+ [Instructions / 使用说明](https://gridzen.ai/developers/harnesses.html) · [Compatibility / 测试记录](clients/compatibility.json)
@@ -1,4 +1,4 @@
1
- # Gridzen Developer Kit 0.3.0
1
+ # Gridzen Developer Kit 0.4.1
2
2
 
3
3
  Research for 198 countries/territories, a verification integration planner, five synthetic outcomes, an HTTP SDK, local MCP server and six Skills. **No live provider is enabled. No real person is verified.** The research snapshot is dated 2026-10-07, with source links and file hashes.
4
4
 
@@ -77,11 +77,12 @@ npx skills add immurray/gridzen-developer-kit
77
77
  Install the tagged Python/MCP release from GitHub (Python 3.11+ and Git):
78
78
 
79
79
  ```sh
80
- python -m pip install "gridzen-developer-kit[mcp] @ git+https://github.com/immurray/gridzen-developer-kit.git@v0.2.0"
80
+ python -m pip install "gridzen-developer-kit[mcp] @ git+https://github.com/immurray/gridzen-developer-kit.git@v0.4.1"
81
81
  ```
82
82
 
83
- A PyPI package is not published yet. Use the GitHub release or website download
84
- until the release tracker records a verified PyPI URL.
83
+ PyPI 0.4.1 is published and verified. Install with `python -m pip install
84
+ gridzen-developer-kit`. See [the release tracker](distribution/STATUS.md) for
85
+ publication and installation evidence.
85
86
 
86
87
  Remote client configuration (conventional JSON; client syntax may vary):
87
88
 
@@ -102,11 +103,13 @@ Original code and Skills: MIT. Research provenance and third-party rights:
102
103
  Source, release downloads, the official MCP Registry entry and six Skills.sh pages are public. Docker catalog submission is awaiting review. See [the publication ledger](distribution/STATUS.md) for exact status and remaining platform steps.
103
104
 
104
105
 
105
- ## Six bundled Skills (0.3.0)
106
+ ## Six bundled Skills (0.4.1)
106
107
 
107
108
  `python -m pip install gridzen-developer-kit` installs the CLI, stdio MCP dependencies
108
- and all six Skill directories. Once 0.3.0 is published, no extra MCP dependency
109
- installation is required. Until then, use the verified GitHub release wheel.
109
+ and all six Skill directories. Version 0.4.1 is published on
110
+ [PyPI](https://pypi.org/project/gridzen-developer-kit/0.4.1/); clean installation,
111
+ CLI, stdio MCP and all six bundled Skill directories were verified. No extra MCP
112
+ dependency installation is required.
110
113
 
111
114
  ```sh
112
115
  gridzen coverage --country MX
@@ -124,3 +127,15 @@ workflows, version 1.0.0: `mexico-pilot-scoper`, `payout-policy-designer`, and
124
127
  `provider-rights-readiness`. Each includes MIT, README, complete response fixtures
125
128
  and agent acceptance prompts. They make no third-party calls and grant no real
126
129
  verification, legal approval or regulatory conclusion.
130
+
131
+ ## Configure your assistant (v0.4.1)
132
+
133
+ ```sh
134
+ python3 -m venv .venv
135
+ . .venv/bin/activate
136
+ python -m pip install --upgrade gridzen-developer-kit
137
+ gridzen setup --client all --project .
138
+ gridzen setup --client all --project . --apply
139
+ ```
140
+
141
+ Use `--client` for Codex, Claude Code/Desktop, Cursor, VS Code/Copilot, Copilot CLI, Gemini CLI, Cline, Roo Code or OpenCode. Setup previews by default, merges existing unrelated settings, backs up changed configurations and refuses differing Gridzen entries or Skill files. No global client settings are modified. Native clients require workspace trust; Desktop and Cline require manual MCP import. Desktop produces six separately uploadable ZIPs. See [client-specific instructions](docs/harness/README.md) and [actual compatibility evidence](clients/compatibility.json). Configuration preparation is not model acceptance or real verification.
@@ -59,11 +59,13 @@ Skills 安装:`npx skills add immurray/gridzen-developer-kit`。
59
59
  源码、版本下载、官方 MCP Registry 和三个 Skills.sh 技能页已公开;Docker 目录投稿待审核。各渠道真实状态及剩余步骤见[发布台账](distribution/STATUS.md)。
60
60
 
61
61
 
62
- ## Six bundled Skills (0.3.0)
62
+ ## Six bundled Skills (0.4.1)
63
63
 
64
64
  `python -m pip install gridzen-developer-kit` installs the CLI, stdio MCP dependencies
65
- and all six Skill directories. Once 0.3.0 is published, no extra MCP dependency
66
- installation is required. Until then, use the verified GitHub release wheel.
65
+ and all six Skill directories. Version 0.4.1 is published on
66
+ [PyPI](https://pypi.org/project/gridzen-developer-kit/0.4.1/); clean installation,
67
+ CLI, stdio MCP and all six bundled Skill directories were verified. No extra MCP
68
+ dependency installation is required.
67
69
 
68
70
  ```sh
69
71
  gridzen coverage --country MX
@@ -81,3 +83,17 @@ workflows, version 1.0.0: `mexico-pilot-scoper`, `payout-policy-designer`, and
81
83
  `provider-rights-readiness`. Each includes MIT, README, complete response fixtures
82
84
  and agent acceptance prompts. They make no third-party calls and grant no real
83
85
  verification, legal approval or regulatory conclusion.
86
+
87
+ ## 统一接入十类助手
88
+
89
+ ```sh
90
+ python3 -m venv .venv
91
+ . .venv/bin/activate
92
+ python -m pip install --upgrade gridzen-developer-kit
93
+ gridzen setup --client all --project .
94
+ gridzen setup --client all --project . --apply
95
+ ```
96
+
97
+ 安装命令需要在 Python 3.11+ 虚拟环境中执行。先预览,再加 --apply。不会修改客户端全局设置;Desktop 和 Cline 需要手动导入,其他客户端需要信任工作区。配置生成成功不代表每个客户端或模型均已实测。
98
+
99
+ [Instructions / 使用说明](https://gridzen.ai/developers/harnesses.html) · [Compatibility / 测试记录](clients/compatibility.json)
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "gridzen": {
4
+ "type": "http",
5
+ "url": "https://gridzen.ai/developers/mcp"
6
+ }
7
+ }
8
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "gridzen": {
4
+ "command": "REPLACE_WITH_ABSOLUTE_PATH_TO_GRIDZEN_MCP",
5
+ "args": []
6
+ }
7
+ }
8
+ }
@@ -0,0 +1,10 @@
1
+ {
2
+ "mcpServers": {
3
+ "gridzen": {
4
+ "type": "streamableHttp",
5
+ "url": "https://gridzen.ai/developers/mcp",
6
+ "disabled": false,
7
+ "autoApprove": []
8
+ }
9
+ }
10
+ }
@@ -0,0 +1,2 @@
1
+ [mcp_servers.gridzen]
2
+ url = "https://gridzen.ai/developers/mcp"
@@ -0,0 +1,181 @@
1
+ {
2
+ "version": "0.4.1",
3
+ "checked_at": "2026-10-09",
4
+ "tools": 5,
5
+ "skills": 6,
6
+ "clients": [
7
+ {
8
+ "client": "codex",
9
+ "config_path": ".codex/config.toml",
10
+ "skill_path": ".agents/skills",
11
+ "template": "clients/codex.toml",
12
+ "manual_import": false,
13
+ "config_tests": "passed",
14
+ "client_version": "0.159.0",
15
+ "skill_discovery": "passed_explicit_inspection_six",
16
+ "mcp_discovery": "passed_five_actual_tool_calls",
17
+ "model_acceptance": "passed_timeout_boundary",
18
+ "reason": "Existing ChatGPT subscription, ephemeral read-only run. Explicitly requested six Skills; this does not test autonomous routing for every Skill. MCP endpoint supplied as an explicit session config override; automatic loading of untrusted project config is not claimed.",
19
+ "official_sources": [
20
+ "https://developers.openai.com/codex/mcp",
21
+ "https://developers.openai.com/codex/skills"
22
+ ]
23
+ },
24
+ {
25
+ "client": "claude-code",
26
+ "config_path": ".mcp.json",
27
+ "skill_path": ".claude/skills",
28
+ "template": "clients/claude-code.json",
29
+ "manual_import": false,
30
+ "config_tests": "passed",
31
+ "client_version": "2.1.295",
32
+ "skill_discovery": "not_tested",
33
+ "mcp_discovery": "blocked_workspace_approval",
34
+ "model_acceptance": "not_tested",
35
+ "reason": "CLI reports configured Gridzen HTTP endpoint pending approval. No logged-in Claude account; model acceptance untested.",
36
+ "official_sources": [
37
+ "https://code.claude.com/docs/en/mcp",
38
+ "https://code.claude.com/docs/en/skills"
39
+ ]
40
+ },
41
+ {
42
+ "client": "claude-desktop",
43
+ "config_path": "gridzen-clients/claude-desktop/claude_desktop_config.json",
44
+ "skill_path": "Six individual skill ZIPs; upload in Customize → Skills",
45
+ "template": "clients/claude-desktop.json",
46
+ "manual_import": true,
47
+ "config_tests": "passed",
48
+ "client_version": null,
49
+ "skill_discovery": "not_tested",
50
+ "mcp_discovery": "not_tested",
51
+ "model_acceptance": "not_tested",
52
+ "reason": "GUI application is absent on this Linux host; config generation tests passed, client/model acceptance untested.",
53
+ "official_sources": [
54
+ "https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop",
55
+ "https://support.claude.com/en/articles/12512198-how-to-create-custom-skills"
56
+ ]
57
+ },
58
+ {
59
+ "client": "cursor",
60
+ "config_path": ".cursor/mcp.json",
61
+ "skill_path": ".cursor/skills",
62
+ "template": "clients/cursor.json",
63
+ "manual_import": false,
64
+ "config_tests": "passed",
65
+ "client_version": null,
66
+ "skill_discovery": "not_tested",
67
+ "mcp_discovery": "not_tested",
68
+ "model_acceptance": "not_tested",
69
+ "reason": "GUI application is absent on this Linux host; config generation tests passed, client/model acceptance untested.",
70
+ "official_sources": [
71
+ "https://cursor.com/docs/mcp",
72
+ "https://cursor.com/docs/skills"
73
+ ]
74
+ },
75
+ {
76
+ "client": "vscode",
77
+ "config_path": ".vscode/mcp.json",
78
+ "skill_path": ".github/skills",
79
+ "template": "clients/vscode.json",
80
+ "manual_import": false,
81
+ "config_tests": "passed",
82
+ "client_version": null,
83
+ "skill_discovery": "not_tested",
84
+ "mcp_discovery": "not_tested",
85
+ "model_acceptance": "not_tested",
86
+ "reason": "GUI application is absent on this Linux host; config generation tests passed, client/model acceptance untested.",
87
+ "official_sources": [
88
+ "https://code.visualstudio.com/docs/agent-customization/mcp-servers",
89
+ "https://code.visualstudio.com/docs/agent-customization/agent-skills"
90
+ ]
91
+ },
92
+ {
93
+ "client": "copilot-cli",
94
+ "config_path": ".github/mcp.json",
95
+ "skill_path": ".github/skills",
96
+ "template": "clients/copilot-cli.json",
97
+ "manual_import": false,
98
+ "config_tests": "passed",
99
+ "client_version": "1.0.94",
100
+ "skill_discovery": "passed_six_native",
101
+ "mcp_discovery": "not_detected_by_mcp_list",
102
+ "model_acceptance": "not_tested",
103
+ "reason": "Native skill list discovers all six. mcp list reports no servers from project files; use documented --additional-mcp-config @clients/copilot-cli.json. No model session or paid calls performed.",
104
+ "official_sources": [
105
+ "https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers",
106
+ "https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference"
107
+ ]
108
+ },
109
+ {
110
+ "client": "gemini-cli",
111
+ "config_path": ".gemini/settings.json",
112
+ "skill_path": ".gemini/skills",
113
+ "template": "clients/gemini-cli.json",
114
+ "manual_import": false,
115
+ "config_tests": "passed",
116
+ "client_version": "0.63.0",
117
+ "skill_discovery": "blocked_workspace_trust",
118
+ "mcp_discovery": "blocked_workspace_trust",
119
+ "model_acceptance": "not_tested",
120
+ "reason": "CLI reads project HTTP configuration but disables MCP and project Skills in untrusted folder. No account/model calls performed.",
121
+ "official_sources": [
122
+ "https://geminicli.com/docs/tools/mcp-server/",
123
+ "https://geminicli.com/docs/cli/skills/"
124
+ ]
125
+ },
126
+ {
127
+ "client": "cline",
128
+ "config_path": "gridzen-clients/cline/cline_mcp_settings.json",
129
+ "skill_path": ".cline/skills",
130
+ "template": "clients/cline.json",
131
+ "manual_import": true,
132
+ "config_tests": "passed",
133
+ "client_version": null,
134
+ "skill_discovery": "not_tested",
135
+ "mcp_discovery": "not_tested",
136
+ "model_acceptance": "not_tested",
137
+ "reason": "GUI application is absent on this Linux host; config generation tests passed, client/model acceptance untested.",
138
+ "official_sources": [
139
+ "https://docs.cline.bot/mcp/mcp-overview",
140
+ "https://docs.cline.bot/customization/skills"
141
+ ]
142
+ },
143
+ {
144
+ "client": "roo-code",
145
+ "config_path": ".roo/mcp.json",
146
+ "skill_path": ".roo/skills",
147
+ "template": "clients/roo-code.json",
148
+ "manual_import": false,
149
+ "config_tests": "passed",
150
+ "client_version": null,
151
+ "skill_discovery": "not_tested",
152
+ "mcp_discovery": "not_tested",
153
+ "model_acceptance": "not_tested",
154
+ "reason": "GUI application is absent on this Linux host; config generation tests passed, client/model acceptance untested.",
155
+ "official_sources": [
156
+ "https://docs.roocode.com/features/mcp/using-mcp-in-roo",
157
+ "https://docs.roocode.com/features/skills"
158
+ ]
159
+ },
160
+ {
161
+ "client": "opencode",
162
+ "config_path": "opencode.json",
163
+ "skill_path": ".opencode/skills",
164
+ "template": "clients/opencode.json",
165
+ "manual_import": false,
166
+ "config_tests": "passed",
167
+ "client_version": "1.18.35",
168
+ "skill_discovery": "passed_six_native",
169
+ "mcp_discovery": "passed_connected",
170
+ "model_acceptance": "not_tested",
171
+ "reason": "Native mcp list connected to public endpoint. Model acceptance untested; no model-provider credentials supplied.",
172
+ "official_sources": [
173
+ "https://opencode.ai/docs/mcp-servers/",
174
+ "https://opencode.ai/docs/skills/"
175
+ ]
176
+ }
177
+ ],
178
+ "notice": "Template/installer validation does not establish real client or model acceptance. No live verification.",
179
+ "client_acceptance_release": "0.4.0",
180
+ "change_scope": "Presentation and shared website shell; five MCP tools and client configuration contract unchanged. Existing model acceptance is historical, not repeated for this presentation release."
181
+ }
@@ -0,0 +1,11 @@
1
+ {
2
+ "mcpServers": {
3
+ "gridzen": {
4
+ "type": "http",
5
+ "url": "https://gridzen.ai/developers/mcp",
6
+ "tools": [
7
+ "*"
8
+ ]
9
+ }
10
+ }
11
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "mcpServers": {
3
+ "gridzen": {
4
+ "url": "https://gridzen.ai/developers/mcp"
5
+ }
6
+ }
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "mcpServers": {
3
+ "gridzen": {
4
+ "httpUrl": "https://gridzen.ai/developers/mcp"
5
+ }
6
+ }
7
+ }
@@ -0,0 +1,10 @@
1
+ {
2
+ "mcp": {
3
+ "gridzen": {
4
+ "type": "remote",
5
+ "url": "https://gridzen.ai/developers/mcp",
6
+ "enabled": true,
7
+ "oauth": false
8
+ }
9
+ }
10
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "gridzen": {
4
+ "type": "streamable-http",
5
+ "url": "https://gridzen.ai/developers/mcp"
6
+ }
7
+ }
8
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "servers": {
3
+ "gridzen": {
4
+ "type": "http",
5
+ "url": "https://gridzen.ai/developers/mcp"
6
+ }
7
+ }
8
+ }
@@ -0,0 +1,18 @@
1
+ # Harness installation
2
+
3
+ Use Python 3.11+, a virtual environment and `gridzen setup --client CLIENT --project .`.
4
+ Preview first, add `--apply` to write. `--client all` prepares all ten clients in one
5
+ project. Native activation still requires workspace trust/restart. Desktop and
6
+ Cline MCP configurations are manual imports; generated files alone do not enable
7
+ them. See each client guide and [actual acceptance](../../clients/compatibility.json).
8
+
9
+ - [codex](codex.md)
10
+ - [claude-code](claude-code.md)
11
+ - [claude-desktop](claude-desktop.md)
12
+ - [cursor](cursor.md)
13
+ - [vscode](vscode.md)
14
+ - [copilot-cli](copilot-cli.md)
15
+ - [gemini-cli](gemini-cli.md)
16
+ - [cline](cline.md)
17
+ - [roo-code](roo-code.md)
18
+ - [opencode](opencode.md)
@@ -0,0 +1,36 @@
1
+ # claude-code · GridZen 0.4.0
2
+
3
+ Python 3.11+; installed GridZen kit. Six Skills and five public MCP tools.
4
+
5
+ ```sh
6
+ python3 -m venv .venv
7
+ . .venv/bin/activate
8
+ python -m pip install --upgrade gridzen-developer-kit
9
+ gridzen setup --client claude-code --project .
10
+ gridzen setup --client claude-code --project . --apply
11
+ ```
12
+
13
+ Windows activation: `.venv\Scripts\Activate.ps1` in PowerShell. If `venv` is
14
+ unavailable on Debian/Ubuntu, install `python3-venv` using the OS package manager.
15
+ Do not bypass the system Python protection. The first setup command previews;
16
+ `--apply` writes project-scoped files, merges the Gridzen server, backs up changed
17
+ config files and refuses different existing Gridzen entries or Skills. No accounts,
18
+ provider keys or model API credentials are installed.
19
+
20
+ MCP target: `.mcp.json`. Skill target: `.claude/skills`.
21
+
22
+
23
+
24
+ Try: “Plan a non-production Mexico payout pilot, identify missing permissions and
25
+ evidence, then test a synthetic provider timeout. Do not authorize a real payment.”
26
+ Expected: draft or missing-information output; simulated=true, verified=false,
27
+ provider_calls=0. Timeouts, missing evidence and unsupported remain inconclusive.
28
+ Tool names are get_coverage, plan_verification, create_sandbox_verification,
29
+ get_sandbox_verification, explain_result.
30
+
31
+ Actual acceptance is recorded in [compatibility.json](../../clients/compatibility.json);
32
+ configuration tests are not a claim of model or graphical-client acceptance.
33
+
34
+ Official sources (checked 2026-10-09):
35
+ - https://code.claude.com/docs/en/mcp
36
+ - https://code.claude.com/docs/en/skills
@@ -0,0 +1,36 @@
1
+ # claude-desktop · GridZen 0.4.0
2
+
3
+ Python 3.11+; installed GridZen kit. Six Skills and five public MCP tools.
4
+
5
+ ```sh
6
+ python3 -m venv .venv
7
+ . .venv/bin/activate
8
+ python -m pip install --upgrade gridzen-developer-kit
9
+ gridzen setup --client claude-desktop --project .
10
+ gridzen setup --client claude-desktop --project . --apply
11
+ ```
12
+
13
+ Windows activation: `.venv\Scripts\Activate.ps1` in PowerShell. If `venv` is
14
+ unavailable on Debian/Ubuntu, install `python3-venv` using the OS package manager.
15
+ Do not bypass the system Python protection. The first setup command previews;
16
+ `--apply` writes project-scoped files, merges the Gridzen server, backs up changed
17
+ config files and refuses different existing Gridzen entries or Skills. No accounts,
18
+ provider keys or model API credentials are installed.
19
+
20
+ MCP target: `gridzen-clients/claude-desktop/claude_desktop_config.json`. Skill target: `Six individual skill ZIPs; upload in Customize → Skills`.
21
+
22
+ Import/merge the generated MCP entry into Claude Desktop’s developer configuration, replacing no existing servers. Setup uses the absolute executable path from this installation. Restart Desktop. Upload the six individual Skill ZIPs in Customize → Skills; a multi-Skill bundle is not a single upload. Account plan, code execution and policy restrictions still apply.
23
+
24
+ Try: “Plan a non-production Mexico payout pilot, identify missing permissions and
25
+ evidence, then test a synthetic provider timeout. Do not authorize a real payment.”
26
+ Expected: draft or missing-information output; simulated=true, verified=false,
27
+ provider_calls=0. Timeouts, missing evidence and unsupported remain inconclusive.
28
+ Tool names are get_coverage, plan_verification, create_sandbox_verification,
29
+ get_sandbox_verification, explain_result.
30
+
31
+ Actual acceptance is recorded in [compatibility.json](../../clients/compatibility.json);
32
+ configuration tests are not a claim of model or graphical-client acceptance.
33
+
34
+ Official sources (checked 2026-10-09):
35
+ - https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop
36
+ - https://support.claude.com/en/articles/12512198-how-to-create-custom-skills
@@ -0,0 +1,36 @@
1
+ # cline · GridZen 0.4.0
2
+
3
+ Python 3.11+; installed GridZen kit. Six Skills and five public MCP tools.
4
+
5
+ ```sh
6
+ python3 -m venv .venv
7
+ . .venv/bin/activate
8
+ python -m pip install --upgrade gridzen-developer-kit
9
+ gridzen setup --client cline --project .
10
+ gridzen setup --client cline --project . --apply
11
+ ```
12
+
13
+ Windows activation: `.venv\Scripts\Activate.ps1` in PowerShell. If `venv` is
14
+ unavailable on Debian/Ubuntu, install `python3-venv` using the OS package manager.
15
+ Do not bypass the system Python protection. The first setup command previews;
16
+ `--apply` writes project-scoped files, merges the Gridzen server, backs up changed
17
+ config files and refuses different existing Gridzen entries or Skills. No accounts,
18
+ provider keys or model API credentials are installed.
19
+
20
+ MCP target: `gridzen-clients/cline/cline_mcp_settings.json`. Skill target: `.cline/skills`.
21
+
22
+ Open Cline MCP Servers → Configure and merge the generated Gridzen entry, or use Remote Servers with Streamable HTTP. The generated project file is a handoff template, not a claim that the extension automatically reads it. Skills are copied into .cline/skills.
23
+
24
+ Try: “Plan a non-production Mexico payout pilot, identify missing permissions and
25
+ evidence, then test a synthetic provider timeout. Do not authorize a real payment.”
26
+ Expected: draft or missing-information output; simulated=true, verified=false,
27
+ provider_calls=0. Timeouts, missing evidence and unsupported remain inconclusive.
28
+ Tool names are get_coverage, plan_verification, create_sandbox_verification,
29
+ get_sandbox_verification, explain_result.
30
+
31
+ Actual acceptance is recorded in [compatibility.json](../../clients/compatibility.json);
32
+ configuration tests are not a claim of model or graphical-client acceptance.
33
+
34
+ Official sources (checked 2026-10-09):
35
+ - https://docs.cline.bot/mcp/mcp-overview
36
+ - https://docs.cline.bot/customization/skills
@@ -0,0 +1,36 @@
1
+ # codex · GridZen 0.4.0
2
+
3
+ Python 3.11+; installed GridZen kit. Six Skills and five public MCP tools.
4
+
5
+ ```sh
6
+ python3 -m venv .venv
7
+ . .venv/bin/activate
8
+ python -m pip install --upgrade gridzen-developer-kit
9
+ gridzen setup --client codex --project .
10
+ gridzen setup --client codex --project . --apply
11
+ ```
12
+
13
+ Windows activation: `.venv\Scripts\Activate.ps1` in PowerShell. If `venv` is
14
+ unavailable on Debian/Ubuntu, install `python3-venv` using the OS package manager.
15
+ Do not bypass the system Python protection. The first setup command previews;
16
+ `--apply` writes project-scoped files, merges the Gridzen server, backs up changed
17
+ config files and refuses different existing Gridzen entries or Skills. No accounts,
18
+ provider keys or model API credentials are installed.
19
+
20
+ MCP target: `.codex/config.toml`. Skill target: `.agents/skills`.
21
+
22
+ Trust this project, then restart Codex. Project .codex/config.toml supplies MCP; .agents/skills supplies Skills. You may instead register user-scope MCP with codex mcp add gridzen --url https://gridzen.ai/developers/mcp.
23
+
24
+ Try: “Plan a non-production Mexico payout pilot, identify missing permissions and
25
+ evidence, then test a synthetic provider timeout. Do not authorize a real payment.”
26
+ Expected: draft or missing-information output; simulated=true, verified=false,
27
+ provider_calls=0. Timeouts, missing evidence and unsupported remain inconclusive.
28
+ Tool names are get_coverage, plan_verification, create_sandbox_verification,
29
+ get_sandbox_verification, explain_result.
30
+
31
+ Actual acceptance is recorded in [compatibility.json](../../clients/compatibility.json);
32
+ configuration tests are not a claim of model or graphical-client acceptance.
33
+
34
+ Official sources (checked 2026-10-09):
35
+ - https://developers.openai.com/codex/mcp
36
+ - https://developers.openai.com/codex/skills