Skip to content

docs(specs): add gonka.ai integration specs (051-gonka-gateway, 052-gonka-native)#3616

Merged
bug-ops merged 1 commit intomainfrom
gonka-ai-integration
May 5, 2026
Merged

docs(specs): add gonka.ai integration specs (051-gonka-gateway, 052-gonka-native)#3616
bug-ops merged 1 commit intomainfrom
gonka-ai-integration

Conversation

@bug-ops
Copy link
Copy Markdown
Owner

@bug-ops bug-ops commented May 5, 2026

Summary

  • Adds specs/051-gonka-gateway/spec.md — Phase 1 GonkaGate gateway integration spec (zero new Rust code, wizard touch-point, vault key convention, full NEVER/invariants/acceptance-criteria sections)
  • Adds specs/052-gonka-native/spec.md — Phase 2 native gonka transport spec (RequestSigner with 5-step signing algorithm, EndpointPool round-robin + fail-skip, send_signed_with_retry contract, LlmProvider method table, config schema, vault zeroization, zeph gonka doctor, risks and mitigations)
  • Updates specs/003-llm-providers/spec.md with provider table rows for both paths
  • Updates specs/README.md with entries for specs 051 and 052

Closes part of epic #3602. These specs are the implementation contract for child issues #3603#3614.

Test plan

  • Both spec files render correctly in Obsidian (frontmatter, wikilinks, admonition blocks)
  • specs/README.md and specs/003-llm-providers/spec.md table entries are correct
  • No code changes — spec review only

…onka-native)

Introduces two specification documents for the gonka.ai decentralized
inference integration (epic #3602):

- specs/051-gonka-gateway/spec.md — Phase 1 GonkaGate hosted gateway:
  zero new Rust code, wizard branch, vault key convention, NEVER/invariants
  sections, acceptance criteria.
- specs/052-gonka-native/spec.md — Phase 2 native gonka transport:
  RequestSigner (k256 + bech32, 5-step signing algorithm), EndpointPool
  (round-robin + fail-skip), send_signed_with_retry contract, LlmProvider
  method table, config schema additions (ProviderKind::Gonka, GonkaNode),
  vault secret zeroization, wizard branch, zeph gonka doctor command,
  risks and mitigations.

Updates specs/003-llm-providers/spec.md and specs/README.md with entries
for both providers.
@github-actions github-actions Bot added documentation Improvements or additions to documentation size/XL Extra large PR (500+ lines) labels May 5, 2026
@bug-ops bug-ops merged commit 430cf02 into main May 5, 2026
20 checks passed
@bug-ops bug-ops deleted the gonka-ai-integration branch May 5, 2026 16:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/XL Extra large PR (500+ lines)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant