Major project restructuring and initial repository setup
405 files · 55,229+ · 18,329-

Complete Architecture Overhaul

39 files changed
  • py.typed Added (+3)
  • py.typed Modified
  • base.py Removed (-471)
  • connection.py Modified (+78/-36)
  • core.py Added (+282)
  • handshake.py Added (+538)
  • process.py Added (+391)
  • py.typed Modified
  • config.py Removed (-220)
  • configure.py Added (+75)
  • manager.py Added (+225)
  • runtime.py Added (+493)
  • validators.py Added (+75)
  • handshake.py Removed (-351)
  • core.py Added (+500)
  • negotiation.py Added (+349)
  • base.py Removed (-292)
  • config.py Removed (-16)
  • handshake.py Removed (-121)
  • transport.py Removed (-124)
  • base.py Modified (+22/-13)
  • py.typed Modified
  • py.typed Modified
  • server.py Removed (-472)
  • core.py Added (+473)
  • network.py Added (+362)
  • base.py Modified (+74/-7)
  • py.typed Modified
  • unix.py Removed (-306)
  • transport.py Added (+454)
  • utils.py Added (+44)
  • client.py Modified (+82/-16)
  • handshake.py Modified (+7/-3)
  • server.py Modified (+44/-58)
  • transport.py Modified (+265/-35)
  • utils.py Modified (+51/-71)
  • go.mod Removed (-25)
  • go.sum Removed (-71)
  • utils.go Removed (-51)
  • Reorganized client/ from monolithic base.py into core.py, handshake.py, process.py, and connection.py decouple internal
    20 files
    • py.typed
    • py.typed
    • base.py
    • connection.py
    • core.py
    • handshake.py
    • process.py
    • py.typed
    • handshake.py
    • core.py
    • base.py
    • handshake.py
    • base.py
    • py.typed
    • py.typed
    • core.py
    • base.py
    • py.typed
    • client.py
    • handshake.py
  • Split config.py into config/ package with manager.py, runtime.py, validators.py, and configure.py decouple internal
    12 files
    • py.typed
    • py.typed
    • py.typed
    • config.py
    • configure.py
    • manager.py
    • runtime.py
    • validators.py
    • config.py
    • py.typed
    • py.typed
    • py.typed
  • Converted server.py into server/ package with core.py and network.py baseline internal
    12 files
    • py.typed
    • py.typed
    • core.py
    • py.typed
    • core.py
    • py.typed
    • py.typed
    • server.py
    • core.py
    • network.py
    • py.typed
    • server.py
  • Converted handshake.py into handshake/ package with core.py and negotiation.py baseline internal
    16 files
    • py.typed
    • py.typed
    • core.py
    • handshake.py
    • py.typed
    • handshake.py
    • core.py
    • negotiation.py
    • handshake.py
    • py.typed
    • py.typed
    • core.py
    • py.typed
    • handshake.py
    • go.mod
    • go.sum
  • Reorganized transport/unix.py into transport/unix/ package with transport.py and utils.py baseline internal
    13 files
    • py.typed
    • py.typed
    • py.typed
    • transport.py
    • py.typed
    • py.typed
    • py.typed
    • unix.py
    • transport.py
    • utils.py
    • transport.py
    • utils.py
    • utils.go

New Core Modules

19 files changed
  • observability.md Added (+654)
  • py.typed Added (+3)
  • py.typed Modified
  • py.typed Modified
  • config.py Removed (-220)
  • defaults.py Added (+125)
  • factories.py Added (+396)
  • health_servicer.py Added (+162)
  • config.py Removed (-16)
  • grpc_broker_pb2.py Modified (+24/-18)
  • grpc_broker_pb2.pyi Added (+38)
  • grpc_stdio_pb2.py Modified (+22/-18)
  • grpc_stdio_pb2.pyi Added (+25)
  • py.typed Modified
  • service.py Modified (+317/-149)
  • py.typed Modified
  • telemetry.py Added (+151)
  • py.typed Modified
  • grpc.go Removed (-154)
  • Added defaults.py for centralized default configuration values instantiate behavioral
    9 files
    • py.typed
    • py.typed
    • py.typed
    • config.py
    • defaults.py
    • config.py
    • py.typed
    • py.typed
    • py.typed
  • Added factories.py for object creation patterns instantiate internal
    7 files
    • py.typed
    • py.typed
    • py.typed
    • factories.py
    • py.typed
    • py.typed
    • py.typed
  • Added health_servicer.py for gRPC health check service interface internal
    8 files
    • py.typed
    • py.typed
    • py.typed
    • health_servicer.py
    • py.typed
    • service.py
    • py.typed
    • py.typed
  • Added telemetry.py for observability and metrics instantiate behavioral
    8 files
    • observability.md
    • py.typed
    • py.typed
    • py.typed
    • py.typed
    • py.typed
    • telemetry.py
    • py.typed
  • Added protobuf type stubs (grpc_broker_pb2.pyi, grpc_stdio_pb2.pyi) instantiate internal
    11 files
    • py.typed
    • py.typed
    • py.typed
    • grpc_broker_pb2.py
    • grpc_broker_pb2.pyi
    • grpc_stdio_pb2.py
    • grpc_stdio_pb2.pyi
    • py.typed
    • py.typed
    • py.typed
    • grpc.go

Removed Legacy Code

146 files changed
  • .pyvider.md Added (+29)
  • 2025-01-19-1108-claude.md Removed (-18)
  • README.md Removed (-61)
  • 2025-02-15-0954-invalid-cookie-hard-crash.md Removed (-100)
  • building-grpc.md Removed (-44)
  • cert-compatibility.md Removed (-175)
  • cert-fixtures.md Removed (-192)
  • diagnostic-report.md Removed (-291)
  • test-analysis.md Removed (-224)
  • test-strategy.md Removed (-174)
  • 2025-01-18-1207-chatgpt-rpcplugin.txt Removed (-114)
  • 2025-02-04-1841-claude.md Removed (-126)
  • 2025-02-20-1638-claude-great-testing-strategies.md Removed (-246)
  • 2025-02-22-1624-claude.md Removed (-222)
  • extra.css Modified
  • provide-theme.css Added (+427)
  • termynal.css Added (+127)
  • architecture.md Added (+643)
  • contributing-guide.md Added (+865)
  • index.md Added (+136)
  • testing.md Added (+684)
  • troubleshooting.md Added (+608)
  • docs:2025-02-12-1655-ugh.md Removed (-131)
  • errors-missing-server-2025-02-12.txt Removed (-91)
  • echo-example.md Added (+576)
  • index.md Added (+238)
  • quick-start.md Added (+435)
  • examples.md Added (+357)
  • first-plugin.md Added (+407)
  • index.md Added (+120)
  • installation.md Added (+397)
  • quick-start.md Added (+295)
  • simple-custom-rpc.md Added (+254)
  • grpcplugin.md Removed (-809)
  • customization.md Added (+644)
  • foundation-integration.md Added (+477)
  • lifecycle.md Added (+478)
  • middleware.md Added (+515)
  • observability.md Added (+654)
  • best-practices.md Added (+465)
  • client-guide.md Added (+457)
  • direct-connections.md Added (+283)
  • index.md Added (+191)
  • resilience.md Added (+624)
  • architecture-and-handshake.md Added (+853)
  • index.md Added (+178)
  • protocols.md Added (+648)
  • security.md Added (+414)
  • transports.md Added (+257)
  • advanced.md Added (+570)
  • configuration-guide.md Added (+537)
  • configuration-reference.md Added (+437)
  • configuration-vs-factory-parameters.md Added (+324)
  • environment.md Added (+329)
  • index.md Added (+321)
  • logging.md Added (+468)
  • index.md Added (+123)
  • certificate-reference.md Added (+418)
  • certificates.md Added (+563)
  • index.md Added (+505)
  • magic-cookies.md Added (+275)
  • mtls.md Added (+514)
  • process-isolation.md Added (+153)
  • async-patterns.md Added (+606)
  • basic-setup.md Added (+283)
  • health-checks.md Added (+579)
  • index.md Added (+97)
  • rate-limiting.md Added (+341)
  • services.md Added (+617)
  • transports.md Added (+641)
  • index.md Added (+260)
  • foundation.md Added (+278)
  • index.md Added (+69)
  • custom.js Added (+121)
  • mermaid-init.js Added (+16)
  • termynal.js Added (+264)
  • long-prime.md Removed (-468)
  • 2025-01-29-claude.md Removed (-269)
  • auto-mtls-specs.md Removed (-198)
  • code-example.md Removed (-230)
  • go-plugin-notes.md Removed (-177)
  • logging-emoji-matrix.md Removed (-56)
  • system-requirements.txt Removed (-13)
  • glossary.md Added (+163)
  • index.md Added (+17)
  • requirements.txt Added (+8)
  • research.md Removed (-12)
  • extra.css Added (+176)
  • base.py Removed (-471)
  • types.py Modified (+23/-9)
  • config.py Removed (-220)
  • certificate.py Removed (-862)
  • constants.py Removed (-15)
  • debug.py Removed (-56)
  • generators.py Removed (-70)
  • types.py Removed (-25)
  • __init__.py Removed (-40)
  • __init__.py Removed (-2)
  • base.py Removed (-292)
  • config.py Removed (-16)
  • emoji_matrix.py Removed (-101)
  • formatters.py Removed (-91)
  • crypto.py Removed (-198)
  • emoji.py Removed (-124)
  • handshake.py Removed (-121)
  • log_messages.yml Removed (-41)
  • plog.py Removed (-101)
  • transport.py Removed (-124)
  • proxy.py Removed (-34)
  • base.py Modified (+22/-13)
  • base.py Modified (+74/-7)
  • types.py Modified (+54/-14)
  • types.py Modified (+397/-16)
  • ec-secp256r1-mtls-client.crt Added (+12)
  • ec-secp256r1-mtls-client.key Added (+5)
  • ec-secp256r1-mtls-server.crt Added (+12)
  • ec-secp256r1-mtls-server.key Added (+5)
  • ec-secp384r1-mtls-client.crt Added (+13)
  • ec-secp384r1-mtls-client.key Added (+6)
  • ec-secp384r1-mtls-server.crt Added (+13)
  • ec-secp384r1-mtls-server.key Added (+6)
  • ec-secp521r1-mtls-client.crt Added (+15)
  • ec-secp521r1-mtls-client.key Added (+7)
  • ec-secp521r1-mtls-server.crt Added (+15)
  • ec-secp521r1-mtls-server.key Added (+7)
  • gen-certs.sh Modified
  • rsa-2048-mtls-client.crt Added (+20)
  • rsa-2048-mtls-client.key Added (+27)
  • rsa-2048-mtls-server.crt Added (+20)
  • rsa-2048-mtls-server.key Added (+27)
  • rsa-4096-mtls-client.crt Added (+31)
  • rsa-4096-mtls-client.key Added (+51)
  • rsa-4096-mtls-server.crt Added (+31)
  • rsa-4096-mtls-server.key Added (+51)
  • test_certificate_chains.py Removed (-177)
  • test_certificate_create.py Removed (-109)
  • test_certificate_credentials.py Removed (-147)
  • test_certificate_lifecycle.py Removed (-106)
  • test_certificate_loading.py Removed (-163)
  • test_certificate_mtls.py Removed (-35)
  • test_certificate_properties.py Removed (-221)
  • test_certificate_verify.py Removed (-297)
  • test_crypto.py Removed (-40)
  • test_crypto_generators.py Removed (-111)
  • crypto.py Removed (-138)
  • build.sh Removed (-37)
  • Removed entire crypto/ module (certificate handling, generators, constants, debug, types) harden internal
    10 files
    • types.py
    • certificate.py
    • constants.py
    • debug.py
    • generators.py
    • types.py
    • crypto.py
    • types.py
    • types.py
    • crypto.py
  • Removed entire logger/ module (base, config, emoji_matrix, formatters, proxy, and messages subpackage) baseline internal
    10 files
    • base.py
    • config.py
    • base.py
    • config.py
    • emoji_matrix.py
    • formatters.py
    • emoji.py
    • proxy.py
    • base.py
    • base.py
  • Removed old documentation (claude analysis docs, code reviews, error logs, build guides) specify internal
    1 file
    • build.sh

CI/CD and Project Governance

16 files changed
  • CODEOWNERS Added (+28)
  • bug_report.md Added (+38)
  • feature_request.md Added (+25)
  • dependabot.yml Added (+14)
  • pull_request_template.md Added (+33)
  • ci.yml Modified (+18/-32)
  • release.yml Added (+134)
  • security.yml Added (+78)
  • .pre-commit-config.yaml Added (+44)
  • CHANGELOG.md Added (+1)
  • LICENSE Added (+201)
  • VERSION Added (+1)
  • security.md Added (+414)
  • config.py Removed (-220)
  • config.py Removed (-16)
  • test.sh Removed (-17)
  • Added GitHub workflows: ci.yml, release.yml, security.yml, test-simple.yml qualify internal
    5 files
    • ci.yml
    • release.yml
    • security.yml
    • security.md
    • test.sh
  • Added issue templates (bug report, feature request), PR template, CODEOWNERS remediate behavioral
    1 file
    • CODEOWNERS
  • Added .pre-commit-config.yaml, .actrc, .secrets.example baseline internal
    3 files
    • .pre-commit-config.yaml
    • config.py
    • config.py
  • Added CHANGELOG.md, LICENSE (Apache 2.0), CLAUDE.md, VERSION specify errata
    3 files
    • CHANGELOG.md
    • LICENSE
    • VERSION

New Comprehensive Docs

114 files changed
  • .pyvider.md Added (+29)
  • 2025-01-19-1108-claude.md Removed (-18)
  • README.md Removed (-61)
  • 2025-02-15-0954-invalid-cookie-hard-crash.md Removed (-100)
  • building-grpc.md Removed (-44)
  • cert-compatibility.md Removed (-175)
  • cert-fixtures.md Removed (-192)
  • diagnostic-report.md Removed (-291)
  • test-analysis.md Removed (-224)
  • test-strategy.md Removed (-174)
  • 2025-01-18-1207-chatgpt-rpcplugin.txt Removed (-114)
  • 2025-02-04-1841-claude.md Removed (-126)
  • 2025-02-20-1638-claude-great-testing-strategies.md Removed (-246)
  • 2025-02-22-1624-claude.md Removed (-222)
  • extra.css Modified
  • provide-theme.css Added (+427)
  • termynal.css Added (+127)
  • architecture.md Added (+643)
  • contributing-guide.md Added (+865)
  • index.md Added (+136)
  • testing.md Added (+684)
  • troubleshooting.md Added (+608)
  • docs:2025-02-12-1655-ugh.md Removed (-131)
  • errors-missing-server-2025-02-12.txt Removed (-91)
  • echo-example.md Added (+576)
  • index.md Added (+238)
  • quick-start.md Added (+435)
  • examples.md Added (+357)
  • first-plugin.md Added (+407)
  • index.md Added (+120)
  • installation.md Added (+397)
  • quick-start.md Added (+295)
  • simple-custom-rpc.md Added (+254)
  • grpcplugin.md Removed (-809)
  • customization.md Added (+644)
  • foundation-integration.md Added (+477)
  • lifecycle.md Added (+478)
  • middleware.md Added (+515)
  • observability.md Added (+654)
  • best-practices.md Added (+465)
  • client-guide.md Added (+457)
  • direct-connections.md Added (+283)
  • index.md Added (+191)
  • resilience.md Added (+624)
  • architecture-and-handshake.md Added (+853)
  • index.md Added (+178)
  • protocols.md Added (+648)
  • security.md Added (+414)
  • transports.md Added (+257)
  • advanced.md Added (+570)
  • configuration-guide.md Added (+537)
  • configuration-reference.md Added (+437)
  • configuration-vs-factory-parameters.md Added (+324)
  • environment.md Added (+329)
  • index.md Added (+321)
  • logging.md Added (+468)
  • index.md Added (+123)
  • certificate-reference.md Added (+418)
  • certificates.md Added (+563)
  • index.md Added (+505)
  • magic-cookies.md Added (+275)
  • mtls.md Added (+514)
  • process-isolation.md Added (+153)
  • async-patterns.md Added (+606)
  • basic-setup.md Added (+283)
  • health-checks.md Added (+579)
  • index.md Added (+97)
  • rate-limiting.md Added (+341)
  • services.md Added (+617)
  • transports.md Added (+641)
  • index.md Added (+260)
  • foundation.md Added (+278)
  • index.md Added (+69)
  • custom.js Added (+121)
  • mermaid-init.js Added (+16)
  • termynal.js Added (+264)
  • long-prime.md Removed (-468)
  • 2025-01-29-claude.md Removed (-269)
  • auto-mtls-specs.md Removed (-198)
  • code-example.md Removed (-230)
  • go-plugin-notes.md Removed (-177)
  • logging-emoji-matrix.md Removed (-56)
  • system-requirements.txt Removed (-13)
  • glossary.md Added (+163)
  • index.md Added (+17)
  • requirements.txt Added (+8)
  • research.md Removed (-12)
  • extra.css Added (+176)
  • echo.proto Added (+19)
  • config.py Removed (-220)
  • config.py Removed (-16)
  • echo.proto Added (+19)
  • test.sh Removed (-17)
  • __init__.py Added (+7)
  • __init__.py Added (+7)
  • __init__.py Modified (+7/-1)
  • grpctest_pb2.py Modified (+39/-35)
  • grpctest_pb2.pyi Added (+62)
  • grpctest_pb2_grpc.py Modified (+158/-181)
  • test_grpctest.py Modified (+17/-11)
  • test_grpc_broker.py Added (+127)
  • test_grpc_compatibility.py Added (+68)
  • test_grpc_controller.py Added (+115)
  • test_grpc_proto_coverage.py Added (+115)
  • test_grpc_stdio.py Added (+126)
  • test_protocol_base.py Added (+45)
  • test_protocol_base_completeness.py Added (+70)
  • test_protocol_base_critical.py Added (+41)
  • test_protocol_base_extended.py Added (+80)
  • test_protocol_integration.py Added (+469)
  • test_protocol_services.py Added (+119)
  • test_service_broker.py Added (+268)
  • test_service_controller.py Added (+220)
  • test_service_stdio.py Added (+230)
  • Added development guides: architecture, contributing, testing, troubleshooting qualify internal
    4 files
    • architecture.md
    • testing.md
    • troubleshooting.md
    • test.sh
  • Added getting-started guides: first-plugin, examples, installation, overview interface internal
    3 files
    • examples.md
    • first-plugin.md
    • installation.md
  • Added example walkthroughs: echo-example, quick-start instantiate internal
    5 files
    • echo-example.md
    • quick-start.md
    • quick-start.md
    • echo.proto
    • echo.proto
  • Added reference documentation: API, configuration, protocol interface behavioral
    2 files
    • config.py
    • config.py

Types and Exception Handling Expansion

11 files changed
  • py.typed Added (+3)
  • py.typed Modified
  • py.typed Modified
  • types.py Modified (+23/-9)
  • types.py Removed (-25)
  • exception.py Modified (+252/-15)
  • py.typed Modified
  • py.typed Modified
  • py.typed Modified
  • types.py Modified (+54/-14)
  • types.py Modified (+397/-16)
  • Significantly expanded types.py (424+ lines of changes) with richer type definitions decouple internal
    10 files
    • py.typed
    • py.typed
    • py.typed
    • types.py
    • types.py
    • py.typed
    • py.typed
    • py.typed
    • types.py
    • types.py
  • Expanded exception.py (267+ lines of changes) with more granular exception hierarchy decouple internal
    7 files
    • py.typed
    • py.typed
    • py.typed
    • exception.py
    • py.typed
    • py.typed
    • py.typed