Skip to content

Add Python SDK#13

Merged
samzong merged 18 commits into
lathe-cli:mainfrom
spencercjh:alice/python-sdk
Jul 3, 2026
Merged

Add Python SDK#13
samzong merged 18 commits into
lathe-cli:mainfrom
spencercjh:alice/python-sdk

Conversation

@spencercjh

@spencercjh spencercjh commented Jul 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

  • add a first-class python/ SDK for kitup with bundle, host, install, and workflow APIs
  • wire Python into shared docs, examples, repo checks, CI, and release publishing
  • keep Python behavior aligned with the shared installer contract and add parity/golden coverage

Downstream validation

  • validated in a real consumer integration PR: Replace skill install with kitup spencercjh/lark-doc-exporter#14 (Replace skill install with kitup)
  • that downstream PR replaces lark-doc-exporter's existing skill install implementation with the kitup Python SDK from this PR line and passes local/full pytest plus GitHub Actions checks on the integration branch

Testing

  • uv run --project python pytest python/tests/test_workflow.py python/tests/test_install.py -q
  • make check

spencercjh added 17 commits July 2, 2026 08:49
@spencercjh
feat(python): scaffold sdk package
c4f7b6c 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
feat(python): add bundle primitives
86ba463 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
feat(python): add bundle primitives
60e18f3 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
feat(python): add host resolution
06815c3 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
fix(python): narrow host planning
9099d42 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
feat(python): add install lifecycle
cb844e4 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
fix(python): replace managed bundle updates
c692b65 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
fix(python): re-export task 4 lifecycle types
688cf6c 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
feat(python): add install workflow helpers
20f43fc 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
fix(python): align workflow selection and github snapshots
a77aabd 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
build(python): wire checks and docs
8286755 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
fix(python): correct example lane and docs
fd3e207 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
build(release): add python package publishing
e9b59a3 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
fix(python): restore workflow stdio defaults
a25e248 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
fix(python): infer tty from workflow input
b087a51 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
build(python): target python 3.14
f82545e 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
fix(python): restore install parity
2f161ac 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh
build(python): switch smoke and format to uv
a75be25 
Signed-off-by: spencercjh <spencercjh@gmail.com>
@spencercjh spencercjh mentioned this pull request Jul 3, 2026
Merged
@spencercjh spencercjh marked this pull request as ready for review July 3, 2026 01:46
@spencercjh spencercjh requested a review from samzong as a code owner July 3, 2026 01:46
@samzong samzong merged commit 4efdbd6 into lathe-cli:main Jul 3, 2026
1 check passed
@spencercjh spencercjh deleted the alice/python-sdk branch July 3, 2026 02:47
spencercjh added a commit to spencercjh/lark-doc-exporter that referenced this pull request Jul 3, 2026
@spencercjh
Replace skill install with kitup (#14)
9004138 
## Summary
- replace lark-doc-exporter's local companion-skill installer with a
kitup-backed adapter
- keep the existing `lark-doc-exporter skill install
--host/--force/--dry-run` CLI surface while switching ownership metadata
to `.kitup.json`
- temporarily depend on upstream `kitup-sdk` from `lathe-cli/kitup`
`main`, and add a local two-host spec so this tool stays constrained to
Codex and Claude

## Validation
- `uv sync`
- `uv run pytest tests/test_skill_install.py tests/test_cli.py -q`
- `uv run ruff format --check src tests`
- `uv run ruff check src tests`
- `uv run pytest`
- `HOME=$(mktemp -d) uv run lark-doc-exporter skill install --host codex
--dry-run`
- GitHub Actions checks green on the PR branch (`lint`, both `test`,
both `build`, `public-doc-e2e`, `ci`)
- upstream-main follow-up:
  - `uv run pytest tests/test_skill_install.py -q`
  - `uv run pytest -q -m 'not e2e_public_doc'`

## Notes
- this draft PR is the downstream validation integration for
`lathe-cli/kitup#13`
- `pyproject.toml` temporarily depends on upstream `kitup-sdk` via
`git+https://github.com/lathe-cli/kitup.git@main#subdirectory=python`
- import surface remains `from kitup import ...`; only the dependency
metadata name changes to `kitup-sdk`
- older pre-kitup managed skill installs written by
`.lark-doc-exporter-install.json` are bridged to `.kitup.json` and
upgrade without requiring `--force`
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@samzong samzong Awaiting requested review from samzong samzong is a code owner

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@spencercjh @samzong