version 0.5.0
Fixed
ctx_import no longer fails on the natural usage pattern. Passing the object returned by ctx_export straight back into ctx_import used to crash (TypeError: ... not dict) because it only accepted a hand-stringified JSON string. This was the most common reported import failure — assistants naturally pass the export result as-is. ctx_import now accepts the object, a JSON string, or a list of project objects.
Added
ctx_doc — verbatim per-project documents. Unlike the WHAT/DONE/NOW/MAP buckets (auto-merged, summarized, sometimes lossy), docs are stored and returned exactly as written. Use kind="plan" for an implementation plan, kind="instructions" for project rules, kind="context" for a full detailed brief — or any free-form kind. Wired through ctx_export/ctx_import, ctx_reset, and the CLI (ctx doc ).
ctx_get(view="detailed") — one call returns the buckets plus the full verbatim update history, notes, and docs. Use it when you need the complete picture (e.g. loading an implementation plan), not just the compact summary. Bounded by CTX_MAX_DETAIL_CHARS (default 20000).
Project instructions doc surfaced automatically — if set via ctx_doc(project, "instructions", ...), it's returned at the top of every ctx_get so any connected assistant sees project rules first.
how_to_ctx() — a built-in usage guide the model can call anytime it's unsure how to use these tools. New users: send Call how_to_ctx() and follow that guide for this and every session. as your first prompt and the assistant teaches itself the workflow.
MCP server-level instructions — clients that support the MCP instructions capability now get a short "how to use one-context" pointer automatically at connect time, no manual prompt required.
Notes
No breaking changes to existing tools or the DB schema (new project_docs table only, added via the normal migration path).
99 tests green (Ubuntu + Windows CI).
No new dependencies, no new network surface, no API keys required — the local, zero-config default path is unchanged.
Upgrade:
pip install -U one-ctx
Then restart your MCP client.