patchr 0.1.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 (167) hide show
  1. patchr-0.1.0/LICENSE +17 -0
  2. patchr-0.1.0/PKG-INFO +137 -0
  3. patchr-0.1.0/README.md +108 -0
  4. patchr-0.1.0/apps/__init__.py +2 -0
  5. patchr-0.1.0/apps/api/__init__.py +2 -0
  6. patchr-0.1.0/apps/api/main.py +652 -0
  7. patchr-0.1.0/apps/benchmarks/__init__.py +1 -0
  8. patchr-0.1.0/apps/benchmarks/main.py +20 -0
  9. patchr-0.1.0/apps/sandbox/__init__.py +1 -0
  10. patchr-0.1.0/apps/sandbox/main.py +20 -0
  11. patchr-0.1.0/apps/worker/__init__.py +2 -0
  12. patchr-0.1.0/apps/worker/main.py +15 -0
  13. patchr-0.1.0/apps/worker/verify.py +14 -0
  14. patchr-0.1.0/patchr.egg-info/PKG-INFO +137 -0
  15. patchr-0.1.0/patchr.egg-info/SOURCES.txt +165 -0
  16. patchr-0.1.0/patchr.egg-info/dependency_links.txt +1 -0
  17. patchr-0.1.0/patchr.egg-info/entry_points.txt +5 -0
  18. patchr-0.1.0/patchr.egg-info/requires.txt +14 -0
  19. patchr-0.1.0/patchr.egg-info/top_level.txt +3 -0
  20. patchr-0.1.0/pyproject.toml +56 -0
  21. patchr-0.1.0/setup.cfg +4 -0
  22. patchr-0.1.0/src/patchr/__init__.py +12 -0
  23. patchr-0.1.0/src/patchr/sdk/__init__.py +20 -0
  24. patchr-0.1.0/src/patchr/sdk/client.py +12 -0
  25. patchr-0.1.0/src/picux/__init__.py +6 -0
  26. patchr-0.1.0/src/picux/agents/__init__.py +5 -0
  27. patchr-0.1.0/src/picux/agents/registry.py +204 -0
  28. patchr-0.1.0/src/picux/api/__init__.py +5 -0
  29. patchr-0.1.0/src/picux/api/service.py +5075 -0
  30. patchr-0.1.0/src/picux/audit/__init__.py +31 -0
  31. patchr-0.1.0/src/picux/audit/activity.py +97 -0
  32. patchr-0.1.0/src/picux/audit/observability.py +55 -0
  33. patchr-0.1.0/src/picux/audit/verification/__init__.py +21 -0
  34. patchr-0.1.0/src/picux/audit/verification/ledger.py +633 -0
  35. patchr-0.1.0/src/picux/benchmarks/__init__.py +5 -0
  36. patchr-0.1.0/src/picux/benchmarks/local.py +286 -0
  37. patchr-0.1.0/src/picux/config.py +140 -0
  38. patchr-0.1.0/src/picux/contracts/__init__.py +22 -0
  39. patchr-0.1.0/src/picux/contracts/handshake.py +122 -0
  40. patchr-0.1.0/src/picux/contracts/integration.py +385 -0
  41. patchr-0.1.0/src/picux/contracts/openapi.py +187 -0
  42. patchr-0.1.0/src/picux/contracts/protocol_map.py +152 -0
  43. patchr-0.1.0/src/picux/contracts/routes.py +980 -0
  44. patchr-0.1.0/src/picux/contracts/schema_catalog.py +125 -0
  45. patchr-0.1.0/src/picux/core/__init__.py +17 -0
  46. patchr-0.1.0/src/picux/core/models.py +148 -0
  47. patchr-0.1.0/src/picux/core/router.py +131 -0
  48. patchr-0.1.0/src/picux/core/runtime.py +42 -0
  49. patchr-0.1.0/src/picux/core/state_machine.py +38 -0
  50. patchr-0.1.0/src/picux/domains/__init__.py +2 -0
  51. patchr-0.1.0/src/picux/domains/bridge/HostRun.py +1104 -0
  52. patchr-0.1.0/src/picux/domains/bridge/__init__.py +6 -0
  53. patchr-0.1.0/src/picux/domains/bridge/engine.py +345 -0
  54. patchr-0.1.0/src/picux/domains/hunt/__init__.py +6 -0
  55. patchr-0.1.0/src/picux/domains/hunt/engine.py +307 -0
  56. patchr-0.1.0/src/picux/domains/hunt/models.py +88 -0
  57. patchr-0.1.0/src/picux/domains/pay/__init__.py +16 -0
  58. patchr-0.1.0/src/picux/domains/pay/adapters.py +607 -0
  59. patchr-0.1.0/src/picux/domains/pay/engine.py +950 -0
  60. patchr-0.1.0/src/picux/domains/pay/models.py +95 -0
  61. patchr-0.1.0/src/picux/domains/proxy/__init__.py +5 -0
  62. patchr-0.1.0/src/picux/domains/proxy/engine.py +466 -0
  63. patchr-0.1.0/src/picux/domains/resolve/__init__.py +5 -0
  64. patchr-0.1.0/src/picux/domains/resolve/engine.py +546 -0
  65. patchr-0.1.0/src/picux/orchestrator/__init__.py +3 -0
  66. patchr-0.1.0/src/picux/orchestrator/engine.py +2840 -0
  67. patchr-0.1.0/src/picux/portals/__init__.py +17 -0
  68. patchr-0.1.0/src/picux/portals/templates.py +272 -0
  69. patchr-0.1.0/src/picux/protocols/__init__.py +1 -0
  70. patchr-0.1.0/src/picux/protocols/a2a/__init__.py +6 -0
  71. patchr-0.1.0/src/picux/protocols/a2a/client.py +51 -0
  72. patchr-0.1.0/src/picux/protocols/a2a/envelope.py +132 -0
  73. patchr-0.1.0/src/picux/protocols/mcp/__init__.py +7 -0
  74. patchr-0.1.0/src/picux/protocols/mcp/client.py +69 -0
  75. patchr-0.1.0/src/picux/protocols/mcp/contract.py +67 -0
  76. patchr-0.1.0/src/picux/protocols/mcp/server.py +76 -0
  77. patchr-0.1.0/src/picux/sandbox/__init__.py +6 -0
  78. patchr-0.1.0/src/picux/sandbox/midnight_arbitrage.py +215 -0
  79. patchr-0.1.0/src/picux/sandbox/models.py +90 -0
  80. patchr-0.1.0/src/picux/sdk/__init__.py +13 -0
  81. patchr-0.1.0/src/picux/sdk/client.py +768 -0
  82. patchr-0.1.0/src/picux/sdk/external.py +245 -0
  83. patchr-0.1.0/src/picux/security/__init__.py +18 -0
  84. patchr-0.1.0/src/picux/security/auth.py +86 -0
  85. patchr-0.1.0/src/picux/security/config_validator.py +58 -0
  86. patchr-0.1.0/src/picux/security/policy.py +158 -0
  87. patchr-0.1.0/src/picux/security/secrets.py +144 -0
  88. patchr-0.1.0/src/picux/signals/__init__.py +1 -0
  89. patchr-0.1.0/src/picux/signals/community/__init__.py +24 -0
  90. patchr-0.1.0/src/picux/signals/community/adapters/__init__.py +7 -0
  91. patchr-0.1.0/src/picux/signals/community/adapters/reddit.py +37 -0
  92. patchr-0.1.0/src/picux/signals/community/adapters/shopify.py +23 -0
  93. patchr-0.1.0/src/picux/signals/community/adapters/web.py +23 -0
  94. patchr-0.1.0/src/picux/signals/community/disambiguation.py +51 -0
  95. patchr-0.1.0/src/picux/signals/community/intake.py +227 -0
  96. patchr-0.1.0/src/picux/signals/community/models.py +102 -0
  97. patchr-0.1.0/src/picux/signals/community/rules.py +91 -0
  98. patchr-0.1.0/src/picux/signals/community/scoring.py +64 -0
  99. patchr-0.1.0/src/picux/storage/__init__.py +41 -0
  100. patchr-0.1.0/src/picux/storage/agents.py +50 -0
  101. patchr-0.1.0/src/picux/storage/cases.py +440 -0
  102. patchr-0.1.0/src/picux/storage/channels.py +476 -0
  103. patchr-0.1.0/src/picux/storage/connectors.py +411 -0
  104. patchr-0.1.0/src/picux/storage/envelopes.py +137 -0
  105. patchr-0.1.0/src/picux/storage/escrows.py +168 -0
  106. patchr-0.1.0/src/picux/storage/events.py +989 -0
  107. patchr-0.1.0/src/picux/storage/keyspace.py +60 -0
  108. patchr-0.1.0/src/picux/storage/mandates.py +107 -0
  109. patchr-0.1.0/src/picux/storage/portals.py +222 -0
  110. patchr-0.1.0/src/picux/storage/postgres.py +2049 -0
  111. patchr-0.1.0/src/picux/storage/providers.py +148 -0
  112. patchr-0.1.0/src/picux/storage/proxy.py +231 -0
  113. patchr-0.1.0/src/picux/storage/receipts.py +131 -0
  114. patchr-0.1.0/src/picux/storage/signals.py +147 -0
  115. patchr-0.1.0/src/picux/storage/tasks.py +179 -0
  116. patchr-0.1.0/src/picux/tools/__init__.py +11 -0
  117. patchr-0.1.0/src/picux/tools/shared.py +2048 -0
  118. patchr-0.1.0/src/picux/verification/__init__.py +5 -0
  119. patchr-0.1.0/src/picux/verification/rollout.py +183 -0
  120. patchr-0.1.0/src/picux/workflows/__init__.py +5 -0
  121. patchr-0.1.0/src/picux/workflows/templates.py +74 -0
  122. patchr-0.1.0/tests/test_a2a_envelope_durability.py +103 -0
  123. patchr-0.1.0/tests/test_a2a_protocol.py +94 -0
  124. patchr-0.1.0/tests/test_agent_registry.py +129 -0
  125. patchr-0.1.0/tests/test_audit_verification.py +287 -0
  126. patchr-0.1.0/tests/test_benchmarks.py +57 -0
  127. patchr-0.1.0/tests/test_bridge_connectors.py +186 -0
  128. patchr-0.1.0/tests/test_bridge_preflight.py +258 -0
  129. patchr-0.1.0/tests/test_bridge_ready_connectors.py +105 -0
  130. patchr-0.1.0/tests/test_brief_contract_parity.py +77 -0
  131. patchr-0.1.0/tests/test_case_channel_portal_workflows.py +867 -0
  132. patchr-0.1.0/tests/test_community_signal_harness.py +240 -0
  133. patchr-0.1.0/tests/test_escrow_durability.py +240 -0
  134. patchr-0.1.0/tests/test_fastapi_contract_parity.py +176 -0
  135. patchr-0.1.0/tests/test_hosted_adapters.py +994 -0
  136. patchr-0.1.0/tests/test_hunt_domain.py +109 -0
  137. patchr-0.1.0/tests/test_integration_events.py +1026 -0
  138. patchr-0.1.0/tests/test_integration_handshake.py +155 -0
  139. patchr-0.1.0/tests/test_integration_manifest.py +103 -0
  140. patchr-0.1.0/tests/test_mandate_durability.py +141 -0
  141. patchr-0.1.0/tests/test_mcp_endpoint.py +81 -0
  142. patchr-0.1.0/tests/test_midnight_arbitrage_sandbox.py +105 -0
  143. patchr-0.1.0/tests/test_orchestrator_run.py +662 -0
  144. patchr-0.1.0/tests/test_pay_domain.py +187 -0
  145. patchr-0.1.0/tests/test_pay_machine_contracts.py +346 -0
  146. patchr-0.1.0/tests/test_phase8_verification.py +154 -0
  147. patchr-0.1.0/tests/test_policy_enforcement_runtime.py +335 -0
  148. patchr-0.1.0/tests/test_protocol_contracts.py +139 -0
  149. patchr-0.1.0/tests/test_proxy_contract.py +193 -0
  150. patchr-0.1.0/tests/test_receipt_export.py +160 -0
  151. patchr-0.1.0/tests/test_resolve_attachment_contact_journey.py +164 -0
  152. patchr-0.1.0/tests/test_resolve_bridge_domains.py +119 -0
  153. patchr-0.1.0/tests/test_resolve_tv_journey.py +294 -0
  154. patchr-0.1.0/tests/test_scaffold.py +97 -0
  155. patchr-0.1.0/tests/test_schema_catalog.py +61 -0
  156. patchr-0.1.0/tests/test_sdk_external_client.py +190 -0
  157. patchr-0.1.0/tests/test_sdk_publish_artifacts.py +40 -0
  158. patchr-0.1.0/tests/test_secret_references.py +118 -0
  159. patchr-0.1.0/tests/test_security_policy.py +107 -0
  160. patchr-0.1.0/tests/test_shared_tools.py +470 -0
  161. patchr-0.1.0/tests/test_solana_escrow_ci.py +71 -0
  162. patchr-0.1.0/tests/test_status_security.py +55 -0
  163. patchr-0.1.0/tests/test_storage_audit.py +154 -0
  164. patchr-0.1.0/tests/test_task_lifecycle.py +139 -0
  165. patchr-0.1.0/tests/test_transport_auth.py +124 -0
  166. patchr-0.1.0/tests/test_web_homepage.py +154 -0
  167. patchr-0.1.0/tests/test_workflow_templates.py +106 -0
patchr-0.1.0/LICENSE ADDED
@@ -0,0 +1,17 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ Copyright 2026 Patchr Core Team
6
+
7
+ Licensed under the Apache License, Version 2.0 (the "License");
8
+ you may not use this file except in compliance with the License.
9
+ You may obtain a copy of the License at
10
+
11
+ http://www.apache.org/licenses/LICENSE-2.0
12
+
13
+ Unless required by applicable law or agreed to in writing, software
14
+ distributed under the License is distributed on an "AS IS" BASIS,
15
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ See the License for the specific language governing permissions and
17
+ limitations under the License.
patchr-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,137 @@
1
+ Metadata-Version: 2.4
2
+ Name: patchr
3
+ Version: 0.1.0
4
+ Summary: Patchr Protocol infrastructure for agentic orchestration and settlement.
5
+ Author: Patchr Core Team
6
+ License-Expression: Apache-2.0
7
+ Keywords: patchr,sdk,mcp,a2a,workflow,agents
8
+ Classifier: Development Status :: 3 - Alpha
9
+ Classifier: Intended Audience :: Developers
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Programming Language :: Python :: 3.11
12
+ Classifier: Programming Language :: Python :: 3.12
13
+ Classifier: Programming Language :: Python :: 3.13
14
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
15
+ Requires-Python: >=3.11
16
+ Description-Content-Type: text/markdown
17
+ License-File: LICENSE
18
+ Provides-Extra: api
19
+ Requires-Dist: fastapi>=0.111; extra == "api"
20
+ Requires-Dist: uvicorn>=0.30; extra == "api"
21
+ Provides-Extra: worker
22
+ Requires-Dist: redis>=5.0; extra == "worker"
23
+ Requires-Dist: rq>=1.16; extra == "worker"
24
+ Provides-Extra: db
25
+ Requires-Dist: psycopg[binary]>=3.2; extra == "db"
26
+ Provides-Extra: dev
27
+ Requires-Dist: pytest>=8.0; extra == "dev"
28
+ Dynamic: license-file
29
+
30
+ # Patchr
31
+
32
+ Patchr is the protocol infrastructure layer for agentic orchestration and settlement.
33
+ External apps, services, and agents communicate with Patchr through the SDK, API contract, MCP, and A2A protocol surfaces.
34
+
35
+ Current status: Phase 78 primitives. Patchr now has three flagship workflow templates, citeable proof cards, first-class HUNT, RESOLVE, BRIDGE, PAY, and PROXY domain primitives, portable proof packs, an Auto-Audit Vault contract, Resolve scam and mobility triage, regulated PROXY human routes, misinformation escalation to PROXY review, durable task lifecycle state, durable mandate records, payment mandate preparation, settlement adapter contracts, BRIDGE connector registry, connector preflight, PROXY human-in-the-loop suspend/resume contracts, durable proxy mission records, durable proxy callback reference lookup, proxy mission/outcome/proof schemas, scoped credential references, redacted secret-reference checks, mandate-session and capability-grant policy evaluation and runtime enforcement across BRIDGE, PAY, and PROXY, durable escrow records, durable A2A envelope records, durable community signal provenance, durable integration event outbox, subscriptions, delivery attempts, ready, chain, single and batch claim, complete, cancel, retry, fail, lease, sweep, retry-scheduling, and queue-stat controls, durable agent capability discovery, A2A envelopes, community signal disambiguation, audit proof-of-value verification, listable receipt and evidence export, bearer-token API/MCP/A2A transport auth, public API status, a security whitepaper, a neutral SDK/API/MCP boundary, a public schema catalog, integration manifest with domain capability and policy discovery, domain-aware compatibility handshake with contract references, developer docs, and a versioned agent-readable protocol map with deterministic digest, method-aware API route metadata, SDK, MCP, schema, manifest parity, and policy metadata, external RESOLVE and PROXY SDK helpers, file-to-base64 RESOLVE intake, claim drafting, contact-channel planning, a damaged-TV RESOLVE journey test, a local developer sandbox with API/SDK/MCP trace access, local benchmark evidence with claim labels, source-hygiene guardrails, source brief contract parity, boundary gap wording cleanup, migration inventory closure, brief surface completeness, FastAPI contract parity for PROXY, rollout verification gates, and machine-readable contracts.
36
+
37
+ ## Local Commands
38
+
39
+ ```bash
40
+ npm install
41
+ npm run dev
42
+ npm run api:dev
43
+ npm run web:dev
44
+ npm run web:build
45
+ npm run verify
46
+ PYTHONPATH=src:. python -m apps.api.main
47
+ PYTHONPATH=src:. python -m apps.worker.main
48
+ PYTHONPATH=src:. python -m apps.worker.verify
49
+ PYTHONPATH=src:. python -m apps.sandbox.main --pretty
50
+ PYTHONPATH=src:. python -m apps.benchmarks.main --iterations 100 --pretty
51
+ PYTHONPATH=src:. python -m unittest discover -s tests -p 'test_*.py'
52
+ ```
53
+
54
+ ## Docs
55
+
56
+ - [GCP Terraform deployment](infra/gcp/terraform/README.md)
57
+ - [Migration plan](docs/picux-migration-plan.md)
58
+ - [Phase 0 inventory](docs/picux-migration-inventory.md)
59
+ - [Phase 5 community signals](docs/phase5-community-signals.md)
60
+ - [Phase 6 external client](docs/phase6-external-client.md)
61
+ - [Phase 7 developer sandbox](docs/phase7-developer-sandbox.md)
62
+ - [Phase 8 verification](docs/phase8-verification-rollout.md)
63
+ - [Phase 9 protocol contracts](docs/phase9-protocol-contracts.md)
64
+ - [Phase 10 HUNT domain](docs/phase10-hunt-domain.md)
65
+ - [Phase 11 agent registry](docs/phase11-agent-registry.md)
66
+ - [Phase 12 audit verification](docs/phase12-audit-verification.md)
67
+ - [Phase 13 receipt export](docs/phase13-receipt-export.md)
68
+ - [Phase 14 A2A envelope](docs/phase14-a2a-envelope.md)
69
+ - [Phase 15 agent registry durability](docs/phase15-agent-registry-durability.md)
70
+ - [Phase 16 task lifecycle](docs/phase16-task-lifecycle.md)
71
+ - [Phase 17 mandate durability](docs/phase17-mandate-durability.md)
72
+ - [Phase 18 escrow durability](docs/phase18-escrow-durability.md)
73
+ - [Phase 19 MCP endpoint](docs/phase19-mcp-endpoint.md)
74
+ - [Phase 20 transport auth](docs/phase20-transport-auth.md)
75
+ - [Phase 21 schema catalog](docs/phase21-schema-catalog.md)
76
+ - [Phase 22 A2A envelope durability](docs/phase22-a2a-envelope-durability.md)
77
+ - [Phase 23 A2A transport auth](docs/phase23-a2a-transport-auth.md)
78
+ - [Phase 24 receipt reconciliation](docs/phase24-receipt-reconciliation.md)
79
+ - [Phase 25 evidence catalog](docs/phase25-evidence-catalog.md)
80
+ - [Phase 26 community signal durability](docs/phase26-community-signal-durability.md)
81
+ - [Phase 27 integration manifest](docs/phase27-integration-manifest.md)
82
+ - [Phase 28 integration handshake](docs/phase28-integration-handshake.md)
83
+ - [Phase 29 integration events](docs/phase29-integration-events.md)
84
+ - [Phase 30 event subscriptions](docs/phase30-event-subscriptions.md)
85
+ - [Phase 31 event deliveries](docs/phase31-event-deliveries.md)
86
+ - [Phase 32 delivery claim and retry](docs/phase32-delivery-claim-retry.md)
87
+ - [Phase 33 delivery leases](docs/phase33-delivery-leases.md)
88
+ - [Phase 34 delivery lease sweep](docs/phase34-delivery-lease-sweep.md)
89
+ - [Phase 35 delivery retry scheduling](docs/phase35-delivery-retry-scheduling.md)
90
+ - [Phase 36 delivery stats](docs/phase36-delivery-stats.md)
91
+ - [Phase 37 delivery fail scheduling](docs/phase37-delivery-fail-scheduling.md)
92
+ - [Phase 38 delivery completion](docs/phase38-delivery-completion.md)
93
+ - [Phase 39 delivery chain](docs/phase39-delivery-chain.md)
94
+ - [Phase 40 delivery cancellation](docs/phase40-delivery-cancellation.md)
95
+ - [Phase 41 delivery ready preview](docs/phase41-delivery-ready.md)
96
+ - [Phase 42 delivery batch claim](docs/phase42-delivery-batch-claim.md)
97
+ - [Phase 43 payment adapters](docs/phase43-payment-adapters.md)
98
+ - [Phase 44 bridge connectors](docs/phase44-bridge-connectors.md)
99
+ - [Phase 45 security policy](docs/phase45-security-policy.md)
100
+ - [Phase 46 developer docs](docs/phase46-developer-docs.md)
101
+ - [Phase 47 sandbox API](docs/phase47-sandbox-api.md)
102
+ - [Phase 48 benchmark evidence](docs/phase48-benchmark-evidence.md)
103
+ - [Phase 49 status and security](docs/phase49-status-security.md)
104
+ - [Phase 50 source hygiene](docs/phase50-source-hygiene.md)
105
+ - [Phase 51 FastAPI contract parity](docs/phase51-fastapi-contract-parity.md)
106
+ - [Phase 52 runtime policy enforcement](docs/phase52-runtime-policy-enforcement.md)
107
+ - [Phase 53 secret reference checks](docs/phase53-secret-reference-checks.md)
108
+ - [Phase 54 BRIDGE preflight](docs/phase54-bridge-preflight.md)
109
+ - [Phase 55 PROXY suspend/resume](docs/phase55-proxy-suspend-resume.md)
110
+ - [Phase 56 PROXY durability](docs/phase56-proxy-durability.md)
111
+ - [Phase 57 PROXY callback refs](docs/phase57-proxy-callback-refs.md)
112
+ - [Phase 58 PROXY policy enforcement](docs/phase58-proxy-policy-enforcement.md)
113
+ - [Phase 59 PROXY FastAPI parity](docs/phase59-proxy-fastapi-parity.md)
114
+ - [Phase 60 PROXY external SDK](docs/phase60-proxy-external-sdk.md)
115
+ - [Phase 61 domain manifest](docs/phase61-domain-manifest.md)
116
+ - [Phase 62 domain handshake](docs/phase62-domain-handshake.md)
117
+ - [Phase 63 domain policy discovery](docs/phase63-domain-policy-discovery.md)
118
+ - [Phase 64 agent-readable policy map](docs/phase64-agent-readable-policy-map.md)
119
+ - [Phase 65 agent map manifest parity](docs/phase65-agent-map-manifest-parity.md)
120
+ - [Phase 66 protocol map surface](docs/phase66-protocol-map-surface.md)
121
+ - [Phase 67 handshake contract references](docs/phase67-handshake-contract-refs.md)
122
+ - [Phase 68 protocol map route metadata](docs/phase68-protocol-map-route-metadata.md)
123
+ - [Phase 69 protocol map version source](docs/phase69-protocol-map-version-source.md)
124
+ - [Phase 70 protocol map digest](docs/phase70-protocol-map-digest.md)
125
+ - [Phase 71 brief contract parity](docs/phase71-brief-contract-parity.md)
126
+ - [Phase 72 boundary gap wording](docs/phase72-boundary-gap-wording.md)
127
+ - [Phase 73 migration inventory closure](docs/phase73-migration-inventory-closure.md)
128
+ - [Phase 74 brief surface completeness](docs/phase74-brief-surface-completeness.md)
129
+ - [Phase 75 resolve TV journey](docs/phase75-resolve-tv-journey.md)
130
+ - [Phase 76 resolve attachment contact](docs/phase76-resolve-attachment-contact.md)
131
+ - [Phase 77 domain proof packs](docs/phase77-domain-proof-packs.md)
132
+ - [Phase 78 workflow templates and proof cards](docs/phase78-workflow-templates-proof-cards.md)
133
+ - [Phase 79 developer activation loop](docs/phase79-developer-activation-loop.md)
134
+ - [Distribution homepage](docs/distribution-homepage.md)
135
+ - [Security whitepaper](docs/security-whitepaper.md)
136
+ - [Developer docs](docs/developers/index.md)
137
+ - [Docs index](docs/index.md)
patchr-0.1.0/README.md ADDED
@@ -0,0 +1,108 @@
1
+ # Patchr
2
+
3
+ Patchr is the protocol infrastructure layer for agentic orchestration and settlement.
4
+ External apps, services, and agents communicate with Patchr through the SDK, API contract, MCP, and A2A protocol surfaces.
5
+
6
+ Current status: Phase 78 primitives. Patchr now has three flagship workflow templates, citeable proof cards, first-class HUNT, RESOLVE, BRIDGE, PAY, and PROXY domain primitives, portable proof packs, an Auto-Audit Vault contract, Resolve scam and mobility triage, regulated PROXY human routes, misinformation escalation to PROXY review, durable task lifecycle state, durable mandate records, payment mandate preparation, settlement adapter contracts, BRIDGE connector registry, connector preflight, PROXY human-in-the-loop suspend/resume contracts, durable proxy mission records, durable proxy callback reference lookup, proxy mission/outcome/proof schemas, scoped credential references, redacted secret-reference checks, mandate-session and capability-grant policy evaluation and runtime enforcement across BRIDGE, PAY, and PROXY, durable escrow records, durable A2A envelope records, durable community signal provenance, durable integration event outbox, subscriptions, delivery attempts, ready, chain, single and batch claim, complete, cancel, retry, fail, lease, sweep, retry-scheduling, and queue-stat controls, durable agent capability discovery, A2A envelopes, community signal disambiguation, audit proof-of-value verification, listable receipt and evidence export, bearer-token API/MCP/A2A transport auth, public API status, a security whitepaper, a neutral SDK/API/MCP boundary, a public schema catalog, integration manifest with domain capability and policy discovery, domain-aware compatibility handshake with contract references, developer docs, and a versioned agent-readable protocol map with deterministic digest, method-aware API route metadata, SDK, MCP, schema, manifest parity, and policy metadata, external RESOLVE and PROXY SDK helpers, file-to-base64 RESOLVE intake, claim drafting, contact-channel planning, a damaged-TV RESOLVE journey test, a local developer sandbox with API/SDK/MCP trace access, local benchmark evidence with claim labels, source-hygiene guardrails, source brief contract parity, boundary gap wording cleanup, migration inventory closure, brief surface completeness, FastAPI contract parity for PROXY, rollout verification gates, and machine-readable contracts.
7
+
8
+ ## Local Commands
9
+
10
+ ```bash
11
+ npm install
12
+ npm run dev
13
+ npm run api:dev
14
+ npm run web:dev
15
+ npm run web:build
16
+ npm run verify
17
+ PYTHONPATH=src:. python -m apps.api.main
18
+ PYTHONPATH=src:. python -m apps.worker.main
19
+ PYTHONPATH=src:. python -m apps.worker.verify
20
+ PYTHONPATH=src:. python -m apps.sandbox.main --pretty
21
+ PYTHONPATH=src:. python -m apps.benchmarks.main --iterations 100 --pretty
22
+ PYTHONPATH=src:. python -m unittest discover -s tests -p 'test_*.py'
23
+ ```
24
+
25
+ ## Docs
26
+
27
+ - [GCP Terraform deployment](infra/gcp/terraform/README.md)
28
+ - [Migration plan](docs/picux-migration-plan.md)
29
+ - [Phase 0 inventory](docs/picux-migration-inventory.md)
30
+ - [Phase 5 community signals](docs/phase5-community-signals.md)
31
+ - [Phase 6 external client](docs/phase6-external-client.md)
32
+ - [Phase 7 developer sandbox](docs/phase7-developer-sandbox.md)
33
+ - [Phase 8 verification](docs/phase8-verification-rollout.md)
34
+ - [Phase 9 protocol contracts](docs/phase9-protocol-contracts.md)
35
+ - [Phase 10 HUNT domain](docs/phase10-hunt-domain.md)
36
+ - [Phase 11 agent registry](docs/phase11-agent-registry.md)
37
+ - [Phase 12 audit verification](docs/phase12-audit-verification.md)
38
+ - [Phase 13 receipt export](docs/phase13-receipt-export.md)
39
+ - [Phase 14 A2A envelope](docs/phase14-a2a-envelope.md)
40
+ - [Phase 15 agent registry durability](docs/phase15-agent-registry-durability.md)
41
+ - [Phase 16 task lifecycle](docs/phase16-task-lifecycle.md)
42
+ - [Phase 17 mandate durability](docs/phase17-mandate-durability.md)
43
+ - [Phase 18 escrow durability](docs/phase18-escrow-durability.md)
44
+ - [Phase 19 MCP endpoint](docs/phase19-mcp-endpoint.md)
45
+ - [Phase 20 transport auth](docs/phase20-transport-auth.md)
46
+ - [Phase 21 schema catalog](docs/phase21-schema-catalog.md)
47
+ - [Phase 22 A2A envelope durability](docs/phase22-a2a-envelope-durability.md)
48
+ - [Phase 23 A2A transport auth](docs/phase23-a2a-transport-auth.md)
49
+ - [Phase 24 receipt reconciliation](docs/phase24-receipt-reconciliation.md)
50
+ - [Phase 25 evidence catalog](docs/phase25-evidence-catalog.md)
51
+ - [Phase 26 community signal durability](docs/phase26-community-signal-durability.md)
52
+ - [Phase 27 integration manifest](docs/phase27-integration-manifest.md)
53
+ - [Phase 28 integration handshake](docs/phase28-integration-handshake.md)
54
+ - [Phase 29 integration events](docs/phase29-integration-events.md)
55
+ - [Phase 30 event subscriptions](docs/phase30-event-subscriptions.md)
56
+ - [Phase 31 event deliveries](docs/phase31-event-deliveries.md)
57
+ - [Phase 32 delivery claim and retry](docs/phase32-delivery-claim-retry.md)
58
+ - [Phase 33 delivery leases](docs/phase33-delivery-leases.md)
59
+ - [Phase 34 delivery lease sweep](docs/phase34-delivery-lease-sweep.md)
60
+ - [Phase 35 delivery retry scheduling](docs/phase35-delivery-retry-scheduling.md)
61
+ - [Phase 36 delivery stats](docs/phase36-delivery-stats.md)
62
+ - [Phase 37 delivery fail scheduling](docs/phase37-delivery-fail-scheduling.md)
63
+ - [Phase 38 delivery completion](docs/phase38-delivery-completion.md)
64
+ - [Phase 39 delivery chain](docs/phase39-delivery-chain.md)
65
+ - [Phase 40 delivery cancellation](docs/phase40-delivery-cancellation.md)
66
+ - [Phase 41 delivery ready preview](docs/phase41-delivery-ready.md)
67
+ - [Phase 42 delivery batch claim](docs/phase42-delivery-batch-claim.md)
68
+ - [Phase 43 payment adapters](docs/phase43-payment-adapters.md)
69
+ - [Phase 44 bridge connectors](docs/phase44-bridge-connectors.md)
70
+ - [Phase 45 security policy](docs/phase45-security-policy.md)
71
+ - [Phase 46 developer docs](docs/phase46-developer-docs.md)
72
+ - [Phase 47 sandbox API](docs/phase47-sandbox-api.md)
73
+ - [Phase 48 benchmark evidence](docs/phase48-benchmark-evidence.md)
74
+ - [Phase 49 status and security](docs/phase49-status-security.md)
75
+ - [Phase 50 source hygiene](docs/phase50-source-hygiene.md)
76
+ - [Phase 51 FastAPI contract parity](docs/phase51-fastapi-contract-parity.md)
77
+ - [Phase 52 runtime policy enforcement](docs/phase52-runtime-policy-enforcement.md)
78
+ - [Phase 53 secret reference checks](docs/phase53-secret-reference-checks.md)
79
+ - [Phase 54 BRIDGE preflight](docs/phase54-bridge-preflight.md)
80
+ - [Phase 55 PROXY suspend/resume](docs/phase55-proxy-suspend-resume.md)
81
+ - [Phase 56 PROXY durability](docs/phase56-proxy-durability.md)
82
+ - [Phase 57 PROXY callback refs](docs/phase57-proxy-callback-refs.md)
83
+ - [Phase 58 PROXY policy enforcement](docs/phase58-proxy-policy-enforcement.md)
84
+ - [Phase 59 PROXY FastAPI parity](docs/phase59-proxy-fastapi-parity.md)
85
+ - [Phase 60 PROXY external SDK](docs/phase60-proxy-external-sdk.md)
86
+ - [Phase 61 domain manifest](docs/phase61-domain-manifest.md)
87
+ - [Phase 62 domain handshake](docs/phase62-domain-handshake.md)
88
+ - [Phase 63 domain policy discovery](docs/phase63-domain-policy-discovery.md)
89
+ - [Phase 64 agent-readable policy map](docs/phase64-agent-readable-policy-map.md)
90
+ - [Phase 65 agent map manifest parity](docs/phase65-agent-map-manifest-parity.md)
91
+ - [Phase 66 protocol map surface](docs/phase66-protocol-map-surface.md)
92
+ - [Phase 67 handshake contract references](docs/phase67-handshake-contract-refs.md)
93
+ - [Phase 68 protocol map route metadata](docs/phase68-protocol-map-route-metadata.md)
94
+ - [Phase 69 protocol map version source](docs/phase69-protocol-map-version-source.md)
95
+ - [Phase 70 protocol map digest](docs/phase70-protocol-map-digest.md)
96
+ - [Phase 71 brief contract parity](docs/phase71-brief-contract-parity.md)
97
+ - [Phase 72 boundary gap wording](docs/phase72-boundary-gap-wording.md)
98
+ - [Phase 73 migration inventory closure](docs/phase73-migration-inventory-closure.md)
99
+ - [Phase 74 brief surface completeness](docs/phase74-brief-surface-completeness.md)
100
+ - [Phase 75 resolve TV journey](docs/phase75-resolve-tv-journey.md)
101
+ - [Phase 76 resolve attachment contact](docs/phase76-resolve-attachment-contact.md)
102
+ - [Phase 77 domain proof packs](docs/phase77-domain-proof-packs.md)
103
+ - [Phase 78 workflow templates and proof cards](docs/phase78-workflow-templates-proof-cards.md)
104
+ - [Phase 79 developer activation loop](docs/phase79-developer-activation-loop.md)
105
+ - [Distribution homepage](docs/distribution-homepage.md)
106
+ - [Security whitepaper](docs/security-whitepaper.md)
107
+ - [Developer docs](docs/developers/index.md)
108
+ - [Docs index](docs/index.md)
@@ -0,0 +1,2 @@
1
+ """Picux application entrypoints."""
2
+
@@ -0,0 +1,2 @@
1
+ """Picux API application."""
2
+