Changelog¶
v1.1.0¶
New features¶
jetsam configverb — view, get, and set configuration from the CLI (P7-003)jetsam ship --draftflag — create draft PRs from the command line (P7-001)
Quality improvements¶
Fix SHA extraction in executor — uses
git rev-parseinstead of fragile output parsing (P5-001)Consolidate
PlatformErrorintoplatforms/base.py— single import for all adapters (P5-002)Add
py.typedmarker for PEP 561 type checking support (P5-003)Add test coverage measurement with
pytest-cov— 63% baseline (P5-004)Trigger expired plan cleanup on MCP server start (P5-005)
v1.0.0¶
API stability¶
All MCP tool error responses standardized to
{error, message, recoverable}format (P6-002)Plan.to_dict()includesparams,scope, andstate_hash(P6-003)9 configuration options wired into planners (P6-001):
auto_push,pr_draft,ship_default,merge_strategy,branch_prefix,delete_on_merge,worktree363 tests, 0 mypy strict errors, 0 lint errors
Platform support¶
GitHub: fully supported via
ghCLIGitLab: core operations supported via
glabCLI; PR comment/review/close operations raiseNotImplementedError(planned for v1.1.0)
v0.3.0¶
Rollup release consolidating agent adoption improvements and bug fixes. See v0.2.0 and v0.2.1 entries below for details.
v0.2.1¶
Bug fixes¶
shipwith explicitfilesparameter now scopes staging exclusively (#4)shipskips commit step when nothing to commit, proceeds to push/PR (#7)savereturns empty plan with warning when nothing to save (#7)_resolve_filesappliesexcludefilter to explicit file lists (#4)
New¶
MCP
ship()tool acceptsfilesparameter for scoped staging
v0.2.0¶
New MCP tools¶
pr_comment — post a comment on a pull request
pr_review — submit a PR review (approve, request-changes, comment)
pr_comments — read comments and reviews on a PR
issue_close — close an issue with optional comment and reason
Agent adoption improvements¶
init --agents claude|gemini|agents|none|<path>— generate agent instruction files (CLAUDE.md, GEMINI.md, etc.) with JetSam routing tableinit --hooks claude|none— generate Claude Code warning hooks that alert agents when they use raw git/gh commands instead of JetSam tools
Bug fixes¶
Fix stash_pop failure when nothing was stashed (#5)
Fix stale plan error when fetch changes repo state (#2)
Simplify sync plan on default branch — fast path for push-only (#3)
Developer experience¶
Resolve all mypy strict errors (14 → 0)
Type
_get_platformreturn asPlatform | Noneinstead ofAny
v0.1.1¶
Document
auto_pushandcommit_messageconfiguration optionsFix
init --mcpto merge into existing.mcp.jsoninstead of overwritingAdd Sphinx documentation for ReadTheDocs
v0.1.0¶
Initial release.
Core workflow verbs¶
status — repository state snapshot
save — stage and commit with smart defaults
sync — fetch, rebase/merge, and push
ship — full pipeline: stage, commit, push, open PR
Inspection verbs¶
log — condensed commit history
diff — diff with smart defaults
pr — PR operations (view/create/list)
prs — list PRs with check and review status
checks — CI check status
issues — list issues from project tracker
Release¶
release — tag, push tag, and create platform release
Platform support¶
GitHub (via
ghCLI)GitLab (via
glabCLI)
Agent integration¶
Built-in MCP server with plan → confirm flow
init --mcpgenerates.mcp.jsonfor Claude Code discovery
Developer experience¶
Shell alias installation (
init --aliases)Shell completions for bash, zsh, fish
Worktree shared paths (
.git-worktree-shared)Error recovery suggestions on common failures
Git pass-through for unrecognized commands