README

bootstrap

Koder Design — Interface facet

Specs sobre *omo componentes Koder se falam* APIs HTTP/REST, RPC, IPC entre apps, command surfaces (CLITUID-Bus), protocolos, versionamento, paginação, error contracts cross-componente.

Parte do *oder Design*programme, facet Interface. Ver rfcs/design-RFC-001 § Facets.

*ota sobre o nome do diretório.*O facet se chama "Interface" mas o diretório é specs/api/ por brevidade e por convenção da indústria (REST API design, gRPC API design). A landing pública apresenta como "Interface" pra ancorar o sentido amplo.

Specs planejadas

Spec Status Ticket
rest.kmd future —
rpc.kmd future —
versioning.kmd future —
pagination.kmd future —
error-contract.kmd future —
auth-headers.kmd future —

Specs existentes que pertencem conceitualmente ao facet Interface

(via cross-link, sem mover os arquivos)

  • meta/docs/stack/specs/ipc/protocol.kmd — IPC entre apps Koder
  • meta/docs/stack/specs/pair/ — pairing protocol
  • meta/docs/stack/specs/commands/ — command surface
  • meta/docs/stack/specs/binaries-and-cli/naming.kmd — naming de CLI

    (k<slug>)

  • meta/docs/stack/specs/chat-channels/ — channel contract
  • meta/docs/stack/specs/cache-purge/contract.kmd
  • meta/docs/stack/specs/settings/patterns.kmd
  • meta/docs/stack/specs/rfc-frontmatter/
  • meta/docs/stack/specs/audit/

Cross-cutting

  • Multitenancy isolation no nível de API: crosstenant = 404

    (specs/multi-tenancy/contract.kmd)

  • Reuse-first: API nova passa pelo audit "já existe SDK?"

    (policies/reuse-first.kmd)

Governance

policies/design-governance.kmd. Mudanças breaking em API exigem versionamento per versioning.kmd (a criar).

Source: ../home/koder/dev/koder/meta/docs/stack/specs/api/README.md