global-support-standard 0.2.0__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 (38) hide show
  1. global_support_standard-0.2.0/LICENSE +9 -0
  2. global_support_standard-0.2.0/PKG-INFO +261 -0
  3. global_support_standard-0.2.0/README.md +226 -0
  4. global_support_standard-0.2.0/pyproject.toml +71 -0
  5. global_support_standard-0.2.0/setup.cfg +4 -0
  6. global_support_standard-0.2.0/src/global_support_standard.egg-info/PKG-INFO +261 -0
  7. global_support_standard-0.2.0/src/global_support_standard.egg-info/SOURCES.txt +36 -0
  8. global_support_standard-0.2.0/src/global_support_standard.egg-info/dependency_links.txt +1 -0
  9. global_support_standard-0.2.0/src/global_support_standard.egg-info/entry_points.txt +4 -0
  10. global_support_standard-0.2.0/src/global_support_standard.egg-info/requires.txt +13 -0
  11. global_support_standard-0.2.0/src/global_support_standard.egg-info/top_level.txt +4 -0
  12. global_support_standard-0.2.0/src/gss_cli/__init__.py +1 -0
  13. global_support_standard-0.2.0/src/gss_cli/main.py +266 -0
  14. global_support_standard-0.2.0/src/gss_core/__init__.py +3 -0
  15. global_support_standard-0.2.0/src/gss_core/envelope.py +18 -0
  16. global_support_standard-0.2.0/src/gss_core/errors.py +22 -0
  17. global_support_standard-0.2.0/src/gss_core/models.py +111 -0
  18. global_support_standard-0.2.0/src/gss_core/security.py +24 -0
  19. global_support_standard-0.2.0/src/gss_provider/__init__.py +3 -0
  20. global_support_standard-0.2.0/src/gss_provider/app.py +452 -0
  21. global_support_standard-0.2.0/src/gss_provider/audit.py +41 -0
  22. global_support_standard-0.2.0/src/gss_provider/auth.py +60 -0
  23. global_support_standard-0.2.0/src/gss_provider/contracts.py +61 -0
  24. global_support_standard-0.2.0/src/gss_provider/mock_adapter.py +77 -0
  25. global_support_standard-0.2.0/src/gss_provider/mock_data.py +104 -0
  26. global_support_standard-0.2.0/src/gss_provider/protocol_engine.py +66 -0
  27. global_support_standard-0.2.0/src/gss_provider/protocols/delivery-not-received.yaml +36 -0
  28. global_support_standard-0.2.0/src/gss_provider/settings.py +44 -0
  29. global_support_standard-0.2.0/src/gss_webshop_shopify/__init__.py +3 -0
  30. global_support_standard-0.2.0/src/gss_webshop_shopify/app.py +500 -0
  31. global_support_standard-0.2.0/src/gss_webshop_shopify/runtime.py +76 -0
  32. global_support_standard-0.2.0/src/gss_webshop_shopify/settings.py +37 -0
  33. global_support_standard-0.2.0/src/gss_webshop_shopify/shopify_client.py +98 -0
  34. global_support_standard-0.2.0/tests/test_cli_integration.py +86 -0
  35. global_support_standard-0.2.0/tests/test_packaging_paths.py +9 -0
  36. global_support_standard-0.2.0/tests/test_provider_api.py +267 -0
  37. global_support_standard-0.2.0/tests/test_security_helpers.py +22 -0
  38. global_support_standard-0.2.0/tests/test_shopify_webshop_project.py +242 -0
@@ -0,0 +1,9 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Global Support Standard Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
6
+
7
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
8
+
9
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
@@ -0,0 +1,261 @@
1
+ Metadata-Version: 2.4
2
+ Name: global-support-standard
3
+ Version: 0.2.0
4
+ Summary: GSS Python MVP: provider API + CLI consumer
5
+ Author: Michel Norbruis
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/MichelN89/global-support-standard
8
+ Project-URL: Repository, https://github.com/MichelN89/global-support-standard
9
+ Project-URL: Issues, https://github.com/MichelN89/global-support-standard/issues
10
+ Project-URL: Documentation, https://github.com/MichelN89/global-support-standard/tree/main/docs
11
+ Project-URL: Changelog, https://github.com/MichelN89/global-support-standard/blob/main/CHANGELOG.md
12
+ Keywords: gss,customer-support,ecommerce,api,cli,fastapi
13
+ Classifier: Development Status :: 3 - Alpha
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Classifier: Framework :: FastAPI
19
+ Requires-Python: >=3.11
20
+ Description-Content-Type: text/markdown
21
+ License-File: LICENSE
22
+ Requires-Dist: fastapi>=0.115.0
23
+ Requires-Dist: uvicorn>=0.30.0
24
+ Requires-Dist: typer>=0.12.0
25
+ Requires-Dist: httpx>=0.27.0
26
+ Requires-Dist: pydantic>=2.8.0
27
+ Requires-Dist: PyYAML>=6.0.1
28
+ Provides-Extra: dev
29
+ Requires-Dist: pytest>=8.2.0; extra == "dev"
30
+ Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
31
+ Requires-Dist: build>=1.2.0; extra == "dev"
32
+ Requires-Dist: twine>=5.1.0; extra == "dev"
33
+ Requires-Dist: ruff>=0.6.0; extra == "dev"
34
+ Dynamic: license-file
35
+
36
+ # Global Support Standard (GSS)
37
+
38
+ Open protocol for machine-readable e-commerce support.
39
+
40
+ [![CI](https://github.com/MichelN89/global-support-standard/actions/workflows/ci.yml/badge.svg)](https://github.com/MichelN89/global-support-standard/actions/workflows/ci.yml)
41
+ [![License](https://img.shields.io/github/license/MichelN89/global-support-standard)](LICENSE)
42
+ [![Python](https://img.shields.io/badge/python-3.11%2B-blue)](pyproject.toml)
43
+
44
+ GSS lets any app, AI agent, or device resolve customer support requests directly with a shop using a consistent command model:
45
+
46
+ ```bash
47
+ gss <shop> <domain> <action> [--flags]
48
+ ```
49
+
50
+ This repository includes a Python MVP implementation of the protocol and supporting project docs.
51
+
52
+ ## Why GSS
53
+
54
+ Most support requests are policy execution, not free-form conversation:
55
+
56
+ - "Where is my package?"
57
+ - "Can I return this item?"
58
+ - "Why is my refund delayed?"
59
+ - "Can you show my account audit trail?"
60
+
61
+ Today these flows are reimplemented per shop and routed through human agents. GSS standardizes these operations so support can be:
62
+
63
+ - Faster (seconds, not days)
64
+ - Consistent across shops
65
+ - Safer for automation (action levels, confirmation tokens, auditability)
66
+ - Consumer-agnostic (AI, mobile app, browser extension, device)
67
+
68
+ ## Repository At A Glance
69
+
70
+ | Area | Purpose |
71
+ |---|---|
72
+ | `src/gss_provider` | FastAPI provider server (shop-facing implementation) |
73
+ | `src/gss_cli` | Typer CLI consumer (`gss` command) |
74
+ | `src/gss_core` | Shared models, envelope helpers, and error contracts |
75
+ | `protocols/` | Protocol format docs and runnable YAML examples |
76
+ | `providers/mock_shop` | Example consumer-policy configuration |
77
+ | `sdk/typescript` | TypeScript SDK scaffold (non-blocking roadmap) |
78
+ | `spec/` | Protocol/spec narrative and architecture references |
79
+ | `docs/` | Getting-started docs for shops and consumers |
80
+ | `tests/` | API and CLI integration tests |
81
+
82
+ ## MVP Scope (Implemented)
83
+
84
+ This codebase currently ships an end-to-end MVP:
85
+
86
+ - Provider API with standardized response envelope
87
+ - CLI with `gss <shop> <domain> <action>` routing
88
+ - Mock shop adapter/data layer
89
+ - Protocol engine (YAML rules + context enrichment)
90
+ - Security baseline:
91
+ - Customer auth token flow
92
+ - Required `GSS-Consumer-*` headers
93
+ - Two-step request execution (`returns initiate` -> `returns confirm`)
94
+ - Append-only audit log records
95
+ - Stateless core boundary:
96
+ - Framework defines contracts and orchestration
97
+ - Shops own persistence/secret storage in adapter implementations
98
+
99
+ ## Architecture
100
+
101
+ ```mermaid
102
+ flowchart LR
103
+ consumerClient[Client app/AI/device] -->|gss commands| cli[gss CLI]
104
+ cli -->|HTTP + GSS headers| provider[gss_provider FastAPI]
105
+ provider --> describe[DescribeService]
106
+ provider --> domains[Domain Services]
107
+ provider --> protocols[Protocol Engine]
108
+ provider --> auth[Auth Context]
109
+ provider --> audit[Audit Logger]
110
+ domains --> adapter[Mock Shop Data]
111
+ protocols --> yaml[Protocol YAML files]
112
+ ```
113
+
114
+ ## Quickstart
115
+
116
+ ### 1) Install
117
+
118
+ ```bash
119
+ python -m venv .venv
120
+ source .venv/bin/activate
121
+ pip install -e ".[dev]"
122
+ ```
123
+
124
+ ### 2) Start provider
125
+
126
+ ```bash
127
+ gss-provider
128
+ ```
129
+
130
+ Default endpoint: `http://127.0.0.1:8000/v1`
131
+
132
+ ### 3) Run consumer flow
133
+
134
+ ```bash
135
+ gss mockshop.local describe
136
+ gss mockshop.local auth login --method api_key --customer-id CUST-001
137
+ gss mockshop.local orders list
138
+ gss mockshop.local orders get --id ORD-1001
139
+ gss mockshop.local shipping track --order-id ORD-1001
140
+ gss mockshop.local protocols get --trigger delivery-not-received --context '{"order_id":"ORD-1002","days_since_expected":1}'
141
+ gss mockshop.local returns initiate --order-id ORD-1001 --item-id ITEM-1 --reason defective
142
+ gss mockshop.local returns confirm --token <confirmation_token>
143
+ gss mockshop.local account audit-log
144
+ ```
145
+
146
+ Optional token behavior:
147
+ - default: CLI stores token locally in `~/.gss/tokens.json`
148
+ - disable local storage: `GSS_STORE_TOKENS=0`
149
+ - provide token explicitly: `GSS_CUSTOMER_TOKEN=<token>`
150
+
151
+ ### Shopify webshop project (inside this repo)
152
+
153
+ ```bash
154
+ gss-shopify-provider
155
+ ```
156
+
157
+ See `webshop/shopify-test-store/README.md` for setup against your test store.
158
+ The Shopify demo includes an agent-first auth flow (`auth verify-customer` -> `auth issue-token`) in addition to legacy dev login.
159
+
160
+ ## HTTP Endpoints (MVP)
161
+
162
+ ### Discovery
163
+ - `GET /v1/describe`
164
+ - `GET /v1/{domain}/describe`
165
+
166
+ ### Auth
167
+ - `POST /v1/auth/login`
168
+
169
+ ### Domains
170
+ - `GET /v1/orders`
171
+ - `GET /v1/orders/{order_id}`
172
+ - `GET /v1/shipping/track/{order_id}`
173
+ - `POST /v1/returns/check-eligibility`
174
+ - `POST /v1/returns/initiate`
175
+ - `POST /v1/returns/confirm`
176
+ - `POST /v1/protocols/get`
177
+ - `GET /v1/account/audit-log`
178
+
179
+ ## Security Model Highlights
180
+
181
+ - Every protected request requires:
182
+ - `Authorization: Bearer <token>`
183
+ - `GSS-Consumer-Id`
184
+ - `GSS-Consumer-Type`
185
+ - `GSS-Version`
186
+ - `request` actions are two-step by design (issue confirmation token, then confirm)
187
+ - Authorization is customer-scoped and domain actions enforce ownership checks
188
+ - Request/action events are recorded to the audit log
189
+ - Trust signaling:
190
+ - `describe` includes compliance metadata (`level`, `certified`, `test_suite_version`)
191
+ - CLI warns when a shop is uncertified or missing compliance metadata
192
+
193
+ ## Production Minimum Config
194
+
195
+ For production deployments, minimum baseline should include:
196
+
197
+ - Auth + headers on protected calls:
198
+ - `Authorization: Bearer <token>`
199
+ - `GSS-Consumer-Id`
200
+ - `GSS-Consumer-Type`
201
+ - `GSS-Version`
202
+ - Token policy:
203
+ - short-lived access tokens (recommended 5-60 minutes)
204
+ - least-privilege scopes per domain/action level
205
+ - optional binding to consumer identity (`GSS-Consumer-Id`)
206
+ - Data guardrails:
207
+ - validate identifiers server-side
208
+ - enforce customer ownership checks before returning payloads
209
+ - fail closed (`VALIDATION_ERROR`/`FORBIDDEN`)
210
+ - Action controls:
211
+ - `request` actions with two-step confirmation
212
+ - `critical` actions with out-of-band verification
213
+ - Governance and CI:
214
+ - branch protection on `main`
215
+ - required checks: lint, tests matrix, coverage, package-check, dependency-audit
216
+ - CODEOWNERS and PR template enabled
217
+
218
+ ## Trust Boundary
219
+
220
+ GSS defines protocol contracts and package logic. Shop implementations own operational security and persistence (token systems, session stores, audit infrastructure).
221
+ See `docs/compliance-and-trust.md` for full guidance.
222
+
223
+ ## Testing
224
+
225
+ ```bash
226
+ pytest
227
+ ```
228
+
229
+ Current test coverage includes:
230
+
231
+ - happy-path API flows
232
+ - forbidden cross-customer order access
233
+ - missing header rejection
234
+ - protocol enrichment behavior
235
+ - CLI integration for login, listing orders, and two-step returns
236
+
237
+ ## Documentation
238
+
239
+ - Spec overview: `spec/overview.md`
240
+ - Architecture deep dive: `docs/architecture.md`
241
+ - API request examples: `docs/api-examples.md`
242
+ - Compliance/trust boundary: `docs/compliance-and-trust.md`
243
+ - Authorization model: `docs/authorization-model.md`
244
+ - Agent delegation model: `docs/agent-delegation-model.md`
245
+ - Multi-language roadmap: `docs/multi-language-roadmap.md`
246
+ - Repository governance: `docs/repository-governance.md`
247
+ - Registry security spec: `docs/registry-security.md`
248
+ - Registry conformance checklist: `docs/registry-conformance-checklist.md`
249
+ - Conformance schema: `schemas/conformance/agent-delegation-checklist.json`
250
+ - Shopify webshop project: `webshop/shopify-test-store/README.md`
251
+ - Shop onboarding: `docs/getting-started-shops.md`
252
+ - Consumer onboarding: `docs/getting-started-consumers.md`
253
+ - Protocol format: `protocols/FORMAT.md`
254
+
255
+ ## Contributing
256
+
257
+ See `CONTRIBUTING.md` for contribution expectations.
258
+
259
+ ## License
260
+
261
+ This project is licensed under the terms in `LICENSE`.
@@ -0,0 +1,226 @@
1
+ # Global Support Standard (GSS)
2
+
3
+ Open protocol for machine-readable e-commerce support.
4
+
5
+ [![CI](https://github.com/MichelN89/global-support-standard/actions/workflows/ci.yml/badge.svg)](https://github.com/MichelN89/global-support-standard/actions/workflows/ci.yml)
6
+ [![License](https://img.shields.io/github/license/MichelN89/global-support-standard)](LICENSE)
7
+ [![Python](https://img.shields.io/badge/python-3.11%2B-blue)](pyproject.toml)
8
+
9
+ GSS lets any app, AI agent, or device resolve customer support requests directly with a shop using a consistent command model:
10
+
11
+ ```bash
12
+ gss <shop> <domain> <action> [--flags]
13
+ ```
14
+
15
+ This repository includes a Python MVP implementation of the protocol and supporting project docs.
16
+
17
+ ## Why GSS
18
+
19
+ Most support requests are policy execution, not free-form conversation:
20
+
21
+ - "Where is my package?"
22
+ - "Can I return this item?"
23
+ - "Why is my refund delayed?"
24
+ - "Can you show my account audit trail?"
25
+
26
+ Today these flows are reimplemented per shop and routed through human agents. GSS standardizes these operations so support can be:
27
+
28
+ - Faster (seconds, not days)
29
+ - Consistent across shops
30
+ - Safer for automation (action levels, confirmation tokens, auditability)
31
+ - Consumer-agnostic (AI, mobile app, browser extension, device)
32
+
33
+ ## Repository At A Glance
34
+
35
+ | Area | Purpose |
36
+ |---|---|
37
+ | `src/gss_provider` | FastAPI provider server (shop-facing implementation) |
38
+ | `src/gss_cli` | Typer CLI consumer (`gss` command) |
39
+ | `src/gss_core` | Shared models, envelope helpers, and error contracts |
40
+ | `protocols/` | Protocol format docs and runnable YAML examples |
41
+ | `providers/mock_shop` | Example consumer-policy configuration |
42
+ | `sdk/typescript` | TypeScript SDK scaffold (non-blocking roadmap) |
43
+ | `spec/` | Protocol/spec narrative and architecture references |
44
+ | `docs/` | Getting-started docs for shops and consumers |
45
+ | `tests/` | API and CLI integration tests |
46
+
47
+ ## MVP Scope (Implemented)
48
+
49
+ This codebase currently ships an end-to-end MVP:
50
+
51
+ - Provider API with standardized response envelope
52
+ - CLI with `gss <shop> <domain> <action>` routing
53
+ - Mock shop adapter/data layer
54
+ - Protocol engine (YAML rules + context enrichment)
55
+ - Security baseline:
56
+ - Customer auth token flow
57
+ - Required `GSS-Consumer-*` headers
58
+ - Two-step request execution (`returns initiate` -> `returns confirm`)
59
+ - Append-only audit log records
60
+ - Stateless core boundary:
61
+ - Framework defines contracts and orchestration
62
+ - Shops own persistence/secret storage in adapter implementations
63
+
64
+ ## Architecture
65
+
66
+ ```mermaid
67
+ flowchart LR
68
+ consumerClient[Client app/AI/device] -->|gss commands| cli[gss CLI]
69
+ cli -->|HTTP + GSS headers| provider[gss_provider FastAPI]
70
+ provider --> describe[DescribeService]
71
+ provider --> domains[Domain Services]
72
+ provider --> protocols[Protocol Engine]
73
+ provider --> auth[Auth Context]
74
+ provider --> audit[Audit Logger]
75
+ domains --> adapter[Mock Shop Data]
76
+ protocols --> yaml[Protocol YAML files]
77
+ ```
78
+
79
+ ## Quickstart
80
+
81
+ ### 1) Install
82
+
83
+ ```bash
84
+ python -m venv .venv
85
+ source .venv/bin/activate
86
+ pip install -e ".[dev]"
87
+ ```
88
+
89
+ ### 2) Start provider
90
+
91
+ ```bash
92
+ gss-provider
93
+ ```
94
+
95
+ Default endpoint: `http://127.0.0.1:8000/v1`
96
+
97
+ ### 3) Run consumer flow
98
+
99
+ ```bash
100
+ gss mockshop.local describe
101
+ gss mockshop.local auth login --method api_key --customer-id CUST-001
102
+ gss mockshop.local orders list
103
+ gss mockshop.local orders get --id ORD-1001
104
+ gss mockshop.local shipping track --order-id ORD-1001
105
+ gss mockshop.local protocols get --trigger delivery-not-received --context '{"order_id":"ORD-1002","days_since_expected":1}'
106
+ gss mockshop.local returns initiate --order-id ORD-1001 --item-id ITEM-1 --reason defective
107
+ gss mockshop.local returns confirm --token <confirmation_token>
108
+ gss mockshop.local account audit-log
109
+ ```
110
+
111
+ Optional token behavior:
112
+ - default: CLI stores token locally in `~/.gss/tokens.json`
113
+ - disable local storage: `GSS_STORE_TOKENS=0`
114
+ - provide token explicitly: `GSS_CUSTOMER_TOKEN=<token>`
115
+
116
+ ### Shopify webshop project (inside this repo)
117
+
118
+ ```bash
119
+ gss-shopify-provider
120
+ ```
121
+
122
+ See `webshop/shopify-test-store/README.md` for setup against your test store.
123
+ The Shopify demo includes an agent-first auth flow (`auth verify-customer` -> `auth issue-token`) in addition to legacy dev login.
124
+
125
+ ## HTTP Endpoints (MVP)
126
+
127
+ ### Discovery
128
+ - `GET /v1/describe`
129
+ - `GET /v1/{domain}/describe`
130
+
131
+ ### Auth
132
+ - `POST /v1/auth/login`
133
+
134
+ ### Domains
135
+ - `GET /v1/orders`
136
+ - `GET /v1/orders/{order_id}`
137
+ - `GET /v1/shipping/track/{order_id}`
138
+ - `POST /v1/returns/check-eligibility`
139
+ - `POST /v1/returns/initiate`
140
+ - `POST /v1/returns/confirm`
141
+ - `POST /v1/protocols/get`
142
+ - `GET /v1/account/audit-log`
143
+
144
+ ## Security Model Highlights
145
+
146
+ - Every protected request requires:
147
+ - `Authorization: Bearer <token>`
148
+ - `GSS-Consumer-Id`
149
+ - `GSS-Consumer-Type`
150
+ - `GSS-Version`
151
+ - `request` actions are two-step by design (issue confirmation token, then confirm)
152
+ - Authorization is customer-scoped and domain actions enforce ownership checks
153
+ - Request/action events are recorded to the audit log
154
+ - Trust signaling:
155
+ - `describe` includes compliance metadata (`level`, `certified`, `test_suite_version`)
156
+ - CLI warns when a shop is uncertified or missing compliance metadata
157
+
158
+ ## Production Minimum Config
159
+
160
+ For production deployments, minimum baseline should include:
161
+
162
+ - Auth + headers on protected calls:
163
+ - `Authorization: Bearer <token>`
164
+ - `GSS-Consumer-Id`
165
+ - `GSS-Consumer-Type`
166
+ - `GSS-Version`
167
+ - Token policy:
168
+ - short-lived access tokens (recommended 5-60 minutes)
169
+ - least-privilege scopes per domain/action level
170
+ - optional binding to consumer identity (`GSS-Consumer-Id`)
171
+ - Data guardrails:
172
+ - validate identifiers server-side
173
+ - enforce customer ownership checks before returning payloads
174
+ - fail closed (`VALIDATION_ERROR`/`FORBIDDEN`)
175
+ - Action controls:
176
+ - `request` actions with two-step confirmation
177
+ - `critical` actions with out-of-band verification
178
+ - Governance and CI:
179
+ - branch protection on `main`
180
+ - required checks: lint, tests matrix, coverage, package-check, dependency-audit
181
+ - CODEOWNERS and PR template enabled
182
+
183
+ ## Trust Boundary
184
+
185
+ GSS defines protocol contracts and package logic. Shop implementations own operational security and persistence (token systems, session stores, audit infrastructure).
186
+ See `docs/compliance-and-trust.md` for full guidance.
187
+
188
+ ## Testing
189
+
190
+ ```bash
191
+ pytest
192
+ ```
193
+
194
+ Current test coverage includes:
195
+
196
+ - happy-path API flows
197
+ - forbidden cross-customer order access
198
+ - missing header rejection
199
+ - protocol enrichment behavior
200
+ - CLI integration for login, listing orders, and two-step returns
201
+
202
+ ## Documentation
203
+
204
+ - Spec overview: `spec/overview.md`
205
+ - Architecture deep dive: `docs/architecture.md`
206
+ - API request examples: `docs/api-examples.md`
207
+ - Compliance/trust boundary: `docs/compliance-and-trust.md`
208
+ - Authorization model: `docs/authorization-model.md`
209
+ - Agent delegation model: `docs/agent-delegation-model.md`
210
+ - Multi-language roadmap: `docs/multi-language-roadmap.md`
211
+ - Repository governance: `docs/repository-governance.md`
212
+ - Registry security spec: `docs/registry-security.md`
213
+ - Registry conformance checklist: `docs/registry-conformance-checklist.md`
214
+ - Conformance schema: `schemas/conformance/agent-delegation-checklist.json`
215
+ - Shopify webshop project: `webshop/shopify-test-store/README.md`
216
+ - Shop onboarding: `docs/getting-started-shops.md`
217
+ - Consumer onboarding: `docs/getting-started-consumers.md`
218
+ - Protocol format: `protocols/FORMAT.md`
219
+
220
+ ## Contributing
221
+
222
+ See `CONTRIBUTING.md` for contribution expectations.
223
+
224
+ ## License
225
+
226
+ This project is licensed under the terms in `LICENSE`.
@@ -0,0 +1,71 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "global-support-standard"
7
+ version = "0.2.0"
8
+ description = "GSS Python MVP: provider API + CLI consumer"
9
+ readme = "README.md"
10
+ requires-python = ">=3.11"
11
+ license = "MIT"
12
+ authors = [
13
+ { name = "Michel Norbruis" },
14
+ ]
15
+ keywords = ["gss", "customer-support", "ecommerce", "api", "cli", "fastapi"]
16
+ classifiers = [
17
+ "Development Status :: 3 - Alpha",
18
+ "Intended Audience :: Developers",
19
+ "Programming Language :: Python :: 3",
20
+ "Programming Language :: Python :: 3.11",
21
+ "Programming Language :: Python :: 3.12",
22
+ "Framework :: FastAPI",
23
+ ]
24
+ dependencies = [
25
+ "fastapi>=0.115.0",
26
+ "uvicorn>=0.30.0",
27
+ "typer>=0.12.0",
28
+ "httpx>=0.27.0",
29
+ "pydantic>=2.8.0",
30
+ "PyYAML>=6.0.1",
31
+ ]
32
+ [project.urls]
33
+ Homepage = "https://github.com/MichelN89/global-support-standard"
34
+ Repository = "https://github.com/MichelN89/global-support-standard"
35
+ Issues = "https://github.com/MichelN89/global-support-standard/issues"
36
+ Documentation = "https://github.com/MichelN89/global-support-standard/tree/main/docs"
37
+ Changelog = "https://github.com/MichelN89/global-support-standard/blob/main/CHANGELOG.md"
38
+
39
+ [project.optional-dependencies]
40
+ dev = [
41
+ "pytest>=8.2.0",
42
+ "pytest-cov>=5.0.0",
43
+ "build>=1.2.0",
44
+ "twine>=5.1.0",
45
+ "ruff>=0.6.0",
46
+ ]
47
+
48
+ [project.scripts]
49
+ gss = "gss_cli.main:run"
50
+ gss-provider = "gss_provider.app:run"
51
+ gss-shopify-provider = "gss_webshop_shopify.app:run"
52
+
53
+ [tool.setuptools]
54
+ package-dir = {"" = "src"}
55
+
56
+ [tool.setuptools.packages.find]
57
+ where = ["src"]
58
+
59
+ [tool.setuptools.package-data]
60
+ gss_provider = ["protocols/*.yaml"]
61
+
62
+ [tool.pytest.ini_options]
63
+ testpaths = ["tests"]
64
+
65
+ [tool.ruff]
66
+ target-version = "py311"
67
+ line-length = 120
68
+
69
+ [tool.ruff.lint]
70
+ select = ["E", "F", "I"]
71
+ ignore = ["E501"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+