witan-core
Shared core for the two witan MCP servers — witan (dist witan-council,
mcp/servers/witan) and witan-code (mcp/servers/witan-code). It is the third
shared packages/ sibling alongside
agent-config-kit, wired into both servers via
a [tool.uv.sources] editable path (dev/CI) plus a published PyPI version range.
Why
The two servers were built copy-paste-and-diverge and carried an explicit "deliberately duplicated — no cross-package import" convention. As the shared surface grew, fixes had to be applied twice and silently drifted — including code that is contractually required to stay identical (the repo-key canonicalizer behind the cross-layer symbol join key; the pinned omnigraph binary version, kept in lockstep by a fragile Renovate custom manager).
witan-core deliberately reverses that convention. The full rationale, scope,
and per-extraction contracts live in
docs/design/witan-core-extraction-spec.md.
Invariant
witan_core imports neither witan nor witan_code. It is a leaf below
both, preserving the one-directional witan → witan_code optional-mount DAG
(witan mounts witan-code as witan code; witan-code never imports witan).
Dependencies
The base package is stdlib-only. Heavier concerns are gated behind extras so neither server pulls weight it doesn't use:
witan-core[cli]→cyclopts,rich(CLI scaffolding, styled installer output)witan-core[mcp]→fastmcp(MCP elicitation primitives)
What's here
Extracted so far (each deletes the duplicated copies from both servers):
_detach.popen_detached— cross-platform detached subprocess spawningomnigraph_install— the pinned-omnigraph-binary installer (single source of the version;richimported lazily)elicit— theconfirm/textMCP elicitation primitives (needs themcpextra; not re-exported from the package root)repo_key—normalise+find_git_config, the cross-layer repo-key canonicalizer, with a golden contract testtimeutil.now_isomaintenance— the throttled-optimize stamp/interval/due mechanicsomnigraph.OmnigraphClient— the omnigraph-CLI subprocess wrapper base (write lock, retry/repair, admission-cap backoff); each server subclasses it (witan addsapply_schema; witan-code adds branch ops + bulkload)config_file.load_toml— shared config.toml loading (WITAN_CONFIGenv var). Both servers read the same file, so one[targets.<name>]block can override both at once.target_config— the[targets.<name>]match/select logic:match_target(prioritymatch_paths>match_repos>match_hosts>match_orgs),parse_target_tables,to_list,local_project_path. Each server keeps its own typed target model (different override fields — witan'sserver/graph/token/…, witan-code'scode_dir) and calls into this shared matcher, which is structurally typed over just the fourmatch_*lists.
Still local to each server (intentionally): the CLI scaffolding — its extraction coordinates with the in-flight multi-user deployment work (see the spec).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file witan_core-0.28.0.tar.gz.
File metadata
- Download URL: witan_core-0.28.0.tar.gz
- Upload date:
- Size: 230.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e9bdb8088a79181bd9b01ad380f9f373f1969fc21bae92b9da2744216323d15c
|
|
| MD5 |
c3e8d7f00085d8d1140fac23c2651624
|
|
| BLAKE2b-256 |
a820bfc4ee782f7e6e595070d8f8547d37e1f53c0b54fdbadf80050cdc09ccd8
|
Provenance
The following attestation bundles were made for witan_core-0.28.0.tar.gz:
Publisher:
publish-witan-core.yml on mitodl/agent-kit
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
witan_core-0.28.0.tar.gz -
Subject digest:
e9bdb8088a79181bd9b01ad380f9f373f1969fc21bae92b9da2744216323d15c - Sigstore transparency entry: 2549964110
- Sigstore integration time:
-
Permalink:
mitodl/agent-kit@4d1caf8565e3d2ad01eae952f07443650afe19a6 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/mitodl
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-witan-core.yml@4d1caf8565e3d2ad01eae952f07443650afe19a6 -
Trigger Event:
push
-
Statement type:
File details
Details for the file witan_core-0.28.0-py3-none-any.whl.
File metadata
- Download URL: witan_core-0.28.0-py3-none-any.whl
- Upload date:
- Size: 134.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4ef2250f98a57a18386ecaa3015a7c3857da78391e0b3c47c9c4dec90cd73b85
|
|
| MD5 |
26ed112439d78f55fedfd756e766a575
|
|
| BLAKE2b-256 |
e29297b4d1f518552166ed74410dba4cc3ddb677be54553eb751a81414d6a04c
|
Provenance
The following attestation bundles were made for witan_core-0.28.0-py3-none-any.whl:
Publisher:
publish-witan-core.yml on mitodl/agent-kit
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
witan_core-0.28.0-py3-none-any.whl -
Subject digest:
4ef2250f98a57a18386ecaa3015a7c3857da78391e0b3c47c9c4dec90cd73b85 - Sigstore transparency entry: 2549964795
- Sigstore integration time:
-
Permalink:
mitodl/agent-kit@4d1caf8565e3d2ad01eae952f07443650afe19a6 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/mitodl
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-witan-core.yml@4d1caf8565e3d2ad01eae952f07443650afe19a6 -
Trigger Event:
push
-
Statement type:
