Skip to content

Releases

cinode-client 0.4.2

Choose a tag to compare

@github-actions github-actions released this 20 Oct 08:05
65a0078

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 in pyproject.toml changed it tags the merge
    commit and dispatches the release workflow, which publishes as before.
    scripts/release.py tag remains for pushing a tag by hand, and
    scripts/release.py version prints 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.whl

See the README for credentials, the CLI output contract and exit codes.

cinode-client 0.4.1

Choose a tag to compare

@github-actions github-actions released this 20 Oct 07:36
22b73fd

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-python was >=3.14,
    though nothing needed it. Unparenthesized except A, B: is parenthesized,
    and modules that annotate with a TYPE_CHECKING-only import use
    from __future__ import annotations.
  • scripts/release.py prepare can release a version without a plan:
    with no version in progress in the roadmap, prepare <version> dates the
    changelog, sets the version and runs uv lock, and leaves the plan and
    roadmap alone. A patch with a plan is named v<major>.<minor>.<patch> in
    the roadmap and docs/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.whl

See the README for credentials, the CLI output contract and exit codes.

cinode-client 0.4.0

Choose a tag to compare

@github-actions github-actions released this 02 Oct 13:20
165e2e2

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: --raw and --jsonl are removed; use --format raw and
    --format jsonl. Raw output one object per line goes with them:
    --format raw always writes one JSON document, and jq -c '.[]' splits a
    list. --format is the only output option, and each command's --help
    lists the formats it takes; any other is a usage error. init and
    config show take --format json and --format table.
  • --format table prints a table for a human to read, with rich: 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 takes raw takes
    table, except users profile get and users resumes get, and so do
    teams skills, init and config show. teams skills is 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. rich is 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.whl

See the README for credentials, the CLI output contract and exit codes.

cinode-client 0.3.0

Choose a tag to compare

@fredrik fredrik released this 24 Sep 20:57
7060bde

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; use Cinode(), which reads
    the environment whenever no credentials are passed.
  • Credentials file: Cinode() and the CLI read access_id and
    access_secret from ~/.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 init checks credentials with whoami() and saves them to the
    credentials file, created with mode 0600 and written atomically. It takes
    them from prompts on a terminal, from --access-id and the first line of
    stdin otherwise, or from the environment with --from-env.
  • cinode config show reports 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.whl

See the README for credentials, the CLI output contract and exit codes.

cinode-client 0.2.0

Choose a tag to compare

@fredrik fredrik released this 24 Sep 13:28
ce41181

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.list and
    users.resumes.get, with the lean Profile, ResumeSummary and Resume
    models, and the commands cinode users profile get, cinode users resumes list and cinode users resumes get. cinode schema gains profile,
    resume and resume-summary. An empty resume list can mean no access.
  • Team profiles: cinode.ops.team_profiles fetches every member's lean
    Profile, recording members it may not read in skipped, as
    team_skills does. It is also cinode teams profiles, and cinode schema
    gains team-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.whl

See the README for credentials, the CLI output contract and exit codes.

cinode-client 0.1.0

Choose a tag to compare

@fredrik fredrik released this 23 Sep 21:25
be44dd0

The first release: a read-only library and CLI for Cinode skills, and the
users, teams and keywords needed to reach them.

  • Library: Cinode with whoami(), users (list, get, skills.list,
    skills.get, teams.list), teams (list, get, members.list) and
    keywords.search. A user is a positive int or "me".
  • Operations: cinode.ops.team_skills fetches every member's skills, and
    records members that return 403 or 404 in skipped.
  • Models: frozen pydantic models with snake_case fields and .raw; an
    unrated skill level (0) becomes None.
  • Transport: GET only. The token is cached and refreshed before expiry and
    once on a 401; /token and other endpoints are rate-limited on the client;
    429, 502, 503, 504 and network errors are retried.
  • Errors: CinodeError and its subclasses, with status, path and
    correlation_id.
  • CLI: cinode mirrors the library, plus teams list --match and
    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.whl

See the README for credentials, the CLI output contract and exit codes.