contractpath

func ContractIDToImportPath ¶

func ContractIDToImportPath(modulePath, id string) string

ContractIDToImportPath converts a contract ID into the fully-qualified Go import path of its generated package, by joining the consuming repo's module path with the module-relative package path from ContractIDToPackagePath:

• ("github.com/acme/svc", "event.session.created.v1") → "github.com/acme/svc/generated/contracts/event/session/created/v1"
• (mod, "http.internal.devicecommands.v1") → mod + "/generated/contracts/http/internalapi/devicecommands/v1"

Single source of truth shared by cellgen (subscription import enrichment) and archtest (adapter return-type import resolution). modulePath comes from the target repo's go.mod — never hardcode the framework module (#1083).

It does NOT validate its inputs: an empty modulePath yields a leading-slash path ("/generated/contracts/..."). Callers must supply a non-empty modulePath (the formatter codegen.FormatGoSource is the fail-closed guard; CLI callers validate via gomodutil.ValidateModulePath).

func ContractIDToPackagePath ¶

func ContractIDToPackagePath(id string) string

ContractIDToPackagePath converts a contract ID to the module-relative generated package path.

• "event.session.created.v1" → "generated/contracts/event/session/created/v1"
• "http.config.internal.get.v1" → "generated/contracts/http/config/internalapi/get/v1"
• "http.internal.devicecommands.v1" → "generated/contracts/http/internalapi/devicecommands/v1"

See Segments for the rewrite rationale.

func Segments ¶

func Segments(id string) []string

Segments returns the path segments for a contract ID's generated package, with each "internal" segment rewritten to "internalapi" so packages under http/internal/... stay importable from cells/ and examples/ (Go's internal package rule would otherwise block cross-directory imports). Callers that need the joined "generated/contracts/..." string use ContractIDToPackagePath; callers that join path segments themselves (e.g. kernel/governance via safeJoinUnderRoot for path-traversal protection) use Segments directly.

Contract IDs (http.internal.X.v1) and URL prefixes (/internal/v1/...) are unchanged; only the generated filesystem path segment is renamed.

ref: golang/go internal package rule (https://go.dev/ref/spec#Internal_packages)