Problem
PR #43 shipped conformant provider SDKs in sdk/typescript, sdk/python, and
sdk/go — each passes the full conformance suite in CI. But they are only usable
from a checkout: npm install @contextgraph/sdk, pip install contextgraph-sdk,
and go get .../sdk/go/contextgraph all dead-end today, exactly like "build a
provider today" did for the crates before #16.
This is the SDK analogue of #16 (publish the crates to crates.io): the code is
done and green, the distribution is the missing half.
Deliverables
- npm — publish
@contextgraph/sdk (public scoped package). Settle the scope
(@contextgraph vs @oxagen), confirm files/.npmignore hygiene (currently
files: ["dist/src"]), then npm publish --access public (with provenance if
desired).
- PyPI — publish
contextgraph-sdk. python -m build (sdist + wheel),
twine upload; confirm the name is free.
- Go — Go modules publish by tag, not a registry. The submodule path is
.../sdk/go, so the tag is sdk/go/v0.1.0, after which
go get github.com/macanderson/context-graph-protocol/sdk/go/contextgraph@v0.1.0
resolves.
- A
PUBLISHING.md-style checklist for the SDKs (mirror the crates one) and
CHANGELOG wiring for SDK versions.
- Optional: a tag → publish release workflow, once the first manual publish is done.
Acceptance
npm install @contextgraph/sdk, pip install contextgraph-sdk, and
go get .../sdk/go/contextgraph@<tag> each work from a clean environment and
can build/run the example provider.
- Versions align (0.1.0) and are recorded in the CHANGELOG.
Notes
The first publish of each is a human action (registry auth/tokens), like #16 —
this issue is the checklist that makes that first publish boring. Blocks the
"install and build a provider in five minutes" story #17 exists for.
Problem
PR #43 shipped conformant provider SDKs in
sdk/typescript,sdk/python, andsdk/go— each passes the full conformance suite in CI. But they are only usablefrom a checkout:
npm install @contextgraph/sdk,pip install contextgraph-sdk,and
go get .../sdk/go/contextgraphall dead-end today, exactly like "build aprovider today" did for the crates before #16.
This is the SDK analogue of #16 (publish the crates to crates.io): the code is
done and green, the distribution is the missing half.
Deliverables
@contextgraph/sdk(public scoped package). Settle the scope(
@contextgraphvs@oxagen), confirmfiles/.npmignorehygiene (currentlyfiles: ["dist/src"]), thennpm publish --access public(with provenance ifdesired).
contextgraph-sdk.python -m build(sdist + wheel),twine upload; confirm the name is free..../sdk/go, so the tag issdk/go/v0.1.0, after whichgo get github.com/macanderson/context-graph-protocol/sdk/go/contextgraph@v0.1.0resolves.
PUBLISHING.md-style checklist for the SDKs (mirror the crates one) andCHANGELOG wiring for SDK versions.
Acceptance
npm install @contextgraph/sdk,pip install contextgraph-sdk, andgo get .../sdk/go/contextgraph@<tag>each work from a clean environment andcan build/run the example provider.
Notes
The first publish of each is a human action (registry auth/tokens), like #16 —
this issue is the checklist that makes that first publish boring. Blocks the
"install and build a provider in five minutes" story #17 exists for.