Repository navigation
Releases
cinode-client 0.4.2
The release flow is fully automatic: merging the release PR tags and publishes
it.
- Merging the release PR releases. A tag workflow runs on every push to
main, and when the version inpyproject.tomlchanged it tags the merge
commit and dispatches the release workflow, which publishes as before.
scripts/release.py tagremains for pushing a tag by hand, and
scripts/release.py versionprints the version at a commit.
Install
uv tool install https://github.com/knowit-solutions-cocreate/cinode-client/releases/download/v0.4.2/cinode_client-0.4.2-py3-none-any.whlSee the README for credentials, the CLI output contract and exit codes.
cinode-client 0.4.1
Python 3.12 and 3.13 are supported, and the release script can release a patch
without a plan.
- Python 3.12 and 3.13 are supported;
requires-pythonwas>=3.14,
though nothing needed it. Unparenthesizedexcept A, B:is parenthesized,
and modules that annotate with aTYPE_CHECKING-only import use
from __future__ import annotations. scripts/release.py preparecan release a version without a plan:
with no version in progress in the roadmap,prepare <version>dates the
changelog, sets the version and runsuv lock, and leaves the plan and
roadmap alone. A patch with a plan is namedv<major>.<minor>.<patch>in
the roadmap anddocs/plans/.
Install
uv tool install https://github.com/knowit-solutions-cocreate/cinode-client/releases/download/v0.4.1/cinode_client-0.4.1-py3-none-any.whlSee the README for credentials, the CLI output contract and exit codes.
cinode-client 0.4.0
Output for humans: --format table prints tables, and --columns picks what
they show. --format is now the only output option, replacing --raw and
--jsonl.
- Breaking:
--rawand--jsonlare removed; use--format rawand
--format jsonl. Raw output one object per line goes with them:
--format rawalways writes one JSON document, andjq -c '.[]'splits a
list.--formatis the only output option, and each command's--help
lists the formats it takes; any other is a usage error.initand
config showtake--format jsonand--format table. --format tableprints a table for a human to read, withrich: one
row per element of a list, with a few default columns, or a Field and
Value table for a single object. Every command that takesrawtakes
table, exceptusers profile getandusers resumes get, and so do
teams skills,initandconfig show.teams skillsis one row per
member and skill, titled with the team's name, and its caption counts the
skipped members by reason. A table's layout is not part of the output contract;
agents keep to JSON.richis now a declared dependency.--columns PATH[,PATH…]picks a table's columns, or a single
object's rows, by path (user.full_name), in the order given. It needs
--format table, and an unknown path is a usage error that lists the
valid ones. It is checked before any request.
Install
uv tool install https://github.com/knowit-solutions-cocreate/cinode-client/releases/download/v0.4.0/cinode_client-0.4.0-py3-none-any.whlSee the README for credentials, the CLI output contract and exit codes.
cinode-client 0.3.0
Credentials set up once: cinode init saves them to a private credentials
file, which the CLI and the library read when the environment has none.
- Breaking:
Cinode.from_env()is removed; useCinode(), which reads
the environment whenever no credentials are passed. - Credentials file:
Cinode()and the CLI readaccess_idand
access_secretfrom~/.config/cinode/credentials.toml(or
$XDG_CONFIG_HOME/cinode/credentials.toml, or$CINODE_CREDENTIALS_FILE)
when the environment holds no credentials. The environment wins as a whole. cinode initchecks credentials withwhoami()and saves them to the
credentials file, created with mode0600and written atomically. It takes
them from prompts on a terminal, from--access-idand the first line of
stdin otherwise, or from the environment with--from-env.cinode config showreports where the credentials in use come from,
and the credentials file's path, existence and permissions, without a
network call.
Install
uv tool install https://github.com/knowit-solutions-cocreate/cinode-client/releases/download/v0.3.0/cinode_client-0.3.0-py3-none-any.whlSee the README for credentials, the CLI output contract and exit codes.
cinode-client 0.2.0
User profiles and resumes, as lean, typed projections of Cinode's payloads.
- Licensed under the MIT licence.
- Profiles and resumes:
users.profile.get,users.resumes.listand
users.resumes.get, with the leanProfile,ResumeSummaryandResume
models, and the commandscinode users profile get,cinode users resumes listandcinode users resumes get.cinode schemagainsprofile,
resumeandresume-summary. An empty resume list can mean no access. - Team profiles:
cinode.ops.team_profilesfetches every member's lean
Profile, recording members it may not read inskipped, as
team_skillsdoes. It is alsocinode teams profiles, andcinode schema
gainsteam-profiles.
Install
uv tool install https://github.com/knowit-solutions-cocreate/cinode-client/releases/download/v0.2.0/cinode_client-0.2.0-py3-none-any.whlSee the README for credentials, the CLI output contract and exit codes.
cinode-client 0.1.0
The first release: a read-only library and CLI for Cinode skills, and the
users, teams and keywords needed to reach them.
- Library:
Cinodewithwhoami(),users(list,get,skills.list,
skills.get,teams.list),teams(list,get,members.list) and
keywords.search. A user is a positiveintor"me". - Operations:
cinode.ops.team_skillsfetches every member's skills, and
records members that return 403 or 404 inskipped. - Models: frozen pydantic models with snake_case fields and
.raw; an
unrated skill level (0) becomesNone. - Transport: GET only. The token is cached and refreshed before expiry and
once on a 401;/tokenand other endpoints are rate-limited on the client;
429, 502, 503, 504 and network errors are retried. - Errors:
CinodeErrorand its subclasses, withstatus,pathand
correlation_id. - CLI:
cinodemirrors the library, plusteams list --matchand
cinode schema. JSON on stdout, a JSON error envelope on stderr, and
documented exit codes. - Tests: unit tests, and a live acceptance suite.
Install
uv tool install https://github.com/knowit-solutions-cocreate/cinode-client/releases/download/v0.1.0/cinode_client-0.1.0-py3-none-any.whlSee the README for credentials, the CLI output contract and exit codes.