Releases: stef-k/CogniRelay
CogniRelay v1.4.14
CogniRelay v1.4.14 Release Notes
Release date: 2026-05-08
Enforce continuity help before mutation
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app tests tools agent-assets
./.venv/bin/python -m unittest discover -s tests -vCogniRelay v1.4.13
CogniRelay v1.4.13 Release Notes
Release date: 2026-05-02
CogniRelay v1.4.13 is a focused patch release for MCP tools/list metadata
consumed by PyPI and MCP Registry users.
Fixed
- Fixed MCP
tools/listmetadata for structured payload fields. continuity.upsertnow advertisescapsuleas an object and
session_end_snapshotas object/null instead of ambiguous string fields.- Generalized top-level structured field inlining across MCP tool schemas.
- Preserved HTTP/runtime validation behavior; JSON-stringified capsules remain
rejected. - Stabilized schedule tests with deterministic future dates.
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app cognirelay tests tools agent-assets
./.venv/bin/python tools/validate_server_json.py
./.venv/bin/python tools/prepare_release.py check --version 1.4.13 --date 2026-05-02 --allow-dirty
./.venv/bin/python -m unittest tests/test_mcp_216_slice2_runtime.py tests/test_mcp_rpc.py tests/test_discovery.py tests/test_schedule_255.py tests/test_continuity_217_slice3_limits.py -v
./.venv/bin/python -m unittest discover -s tests -v
./.venv/bin/python -m build
./.venv/bin/python -m twine check dist/*CogniRelay v1.4.12
CogniRelay v1.4.12 Release Notes
Release date: 2026-04-28
This corrective release fixes the installed agent-asset CLI after normal PyPI
installation.
Fixed
- Allowed the expected pip-generated
hooks/__pycache__/*.pycfiles for the
two packaged hook modules when validating installedcognirelay/agent_assets. - Kept validation strict for any other extra files under
cognirelay/agent_assets, including unrelated bytecode, temp files, logs,
tokens, or runtime residue. - Preserved the wheel allowlist: the wheel itself still contains exactly the
five shipped last-mile agent asset files.
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app cognirelay tests tools agent-assets
./.venv/bin/python tools/validate_server_json.py
./.venv/bin/python tools/prepare_release.py check --version 1.4.12 --date 2026-04-28 --allow-dirty
./.venv/bin/python -m unittest discover -s tests -v
./.venv/bin/python -m build
./.venv/bin/python -m twine check dist/*CogniRelay v1.4.11
CogniRelay v1.4.11 Release Notes
Release date: 2026-04-28
This release makes the last-mile agent integration kit available from a normal
PyPI wheel install.
Changed
- Added the shipped continuity retrieval/save hooks and continuity-authoring
skill to the installed wheel undercognirelay/agent_assets. - Added
cognirelay assets path,cognirelay assets list, and
cognirelay assets copy --to <dir>so agents can discover or materialize the
last-mile assets without cloning the full repository. - Kept full source documentation, deploy templates, tests, runtime state, and
private/local residue out of the wheel while preserving source/sdist behavior.
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app cognirelay tests tools agent-assets
./.venv/bin/python tools/validate_server_json.py
./.venv/bin/python tools/prepare_release.py check --version 1.4.11 --date 2026-04-28 --allow-dirty
./.venv/bin/python -m unittest discover -s tests -v
./.venv/bin/python -m build
./.venv/bin/python -m twine check dist/*CogniRelay v1.4.10
CogniRelay v1.4.10 Release Notes
Release date: 2026-04-27
This metadata-only release aligns the PyPI and MCP Registry discovery text with
the GitHub project description and topics:
Self-hosted continuity and collaboration substrate for autonomous agents with
bounded, recoverable memory and explicit restart orientation
It also adds the GitHub project topics as PyPI package keywords so the package is
easier to discover by agents and operators searching for MCP, agent memory,
continuity, context recovery, session recovery, and self-hosted agent
infrastructure.
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app tests tools agent-assets
./.venv/bin/python -m unittest discover -s tests -vCogniRelay v1.4.9
CogniRelay v1.4.9 Release Notes
Release date: 2026-04-27
CogniRelay v1.4.9 adds the packaging and publication surfaces needed for a
first PyPI and MCP Registry release, while preserving the existing source
checkout deployment path.
Added
- Added PyPI project metadata with a sanitized
README-PYPI.mdlong
description andcognirelayconsole entrypoint. - Added a thin
cognirelaypackage wrapper withcognirelay serveand
python -m cognirelay serve, delegating to the existingapp.main:app
runtime. - Added root
server.jsonmetadata for MCP Registry publication, including
local Streamable HTTP transport, positionalservestartup metadata, and
requiredCOGNIRELAY_REPO_ROOTenvironment metadata. - Added
tools/validate_server_json.pyfor local validation against the
committed MCP Registry schema URL.
Changed
- Extended
tools/prepare_release.pyto validate package versions,
dependencies,server.json, the PyPI ownership marker, and publishable tree
safety before release. - Updated installation documentation for source, PyPI, and production
hardening paths, including durableCOGNIRELAY_REPO_ROOTguidance and the
local Streamable HTTP-only MCP Registry posture. - Added wheel and sdist artifact checks so packaged releases include only the
intended runtime assets and source-only documentation/deploy files.
Security And Privacy
- Removed tracked
data_repo/runtime state from the Git source surface while
preserving local operator files on disk. - Added publishable-tree safety checks that block tracked runtime state,
generated databases, logs, token/key files, build residue, and private
artifacts before publication. - Sanitized PyPI metadata so the published long description does not expose
local runtime-state paths, audit/log paths, capsule paths, or token file
locations. - Added runtime guardrails so installed-package startup refuses unsafe runtime
state roots under package orsite-packagespaths before creating state.
Notes
- No PyPI upload, MCP Registry publication, or GitHub Release publication is
performed by the code change itself; those remain explicit manual release
steps. - Runtime MCP protocol support remains
2025-06-18and2025-11-25. The
2025-12-11value used byserver.jsonis the MCP Registry metadata schema,
not a CogniRelay runtime protocol version.
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app tests tools agent-assets
./.venv/bin/python -m unittest discover -s tests -v
./.venv/bin/python tools/validate_server_json.py
./.venv/bin/python -m build
./.venv/bin/python -m twine check dist/*CogniRelay v1.4.8
CogniRelay v1.4.8 Release Notes
Release date: 2026-04-26
CogniRelay v1.4.8 is a focused packaging compatibility patch for the shipped
last-mile adapter skill. It fixes the cognirelay-continuity-authoring skill
from v1.4.7 so common skill loaders can accept it directly from
agent-assets/.
Highlights
- Added YAML frontmatter to the shipped
cognirelay-continuity-authoring
skill. - Preserved the existing skill body and responsibility split: CogniRelay is the
substrate, the running agent authors semantic continuity fields, and hooks or
adapters do not infer semantic meaning. - Added a flexible regression test that validates the frontmatter block without
overfitting line positions.
Compatibility Notes
- Runtime version is now
1.4.8. - Existing HTTP, MCP, graph, schedule, continuity, UI, and adapter-hook behavior
is unchanged. - The
GET /v1/capabilitiesversionfield remains the capability schema
version ("1").
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app tests tools agent-assets
./.venv/bin/python -m unittest tests/test_agent_assets_289.py -v
./.venv/bin/python -m unittest discover -s tests -vCogniRelay v1.4.7
CogniRelay v1.4.7 Release Notes
Release date: 2026-04-26
CogniRelay v1.4.7 ships the last-mile adapter kit for agent-authored
continuity integration. It is a distribution and integration-quality release:
the runtime API remains stable except for the added help topic, while operators
now get copyable assets for safe agent startup/retrieval and continuity saves.
Highlights
- Added
agent-assets/with a copyablecognirelay-continuity-authoring
skill and real stdlib-only Python hooks for retrieval and continuity save
flows. - The retrieval hook performs read-only startup orientation and optional
bounded context retrieval, surfacing graph and schedule orientation without
mutating continuity, tasks, or schedule items. - The continuity save hook supports
facts,template,dry-run,write,
readback, anddoctormodes with deterministic JSON output, placeholder
rejection, local-only dry-run diffs, and readback verification. - Added the runtime help topic
last-mile-adapter, available over HTTP and MCP
throughsystem.topic_help. - Updated agent onboarding and the documentation index so cold-start agents can
discover the shipped adapter kit and the responsibility split.
Compatibility Notes
- Runtime version is now
1.4.7. - Existing HTTP, MCP, graph, schedule, continuity, and UI behavior is unchanged
except for the added help topic and documentation/assets. - The adapter hooks are shipped as copyable assets. They do not become server
runtime behavior and do not infer semantic continuity content. - Scheduling guidance remains bounded: agents may create one-shot reminders
explicitly when needed, but the adapter hooks do not create, acknowledge,
retire, execute, or mutate schedule items. - The
GET /v1/capabilitiesversionfield remains the capability schema
version ("1").
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app tests tools agent-assets
./.venv/bin/python -m unittest tests/test_agent_assets_289.py -v
./.venv/bin/python -m unittest tests/test_help_214_slice1.py tests/test_help_243_runtime_onboarding_limits.py tests/test_mcp_216_slice3_help.py -v
./.venv/bin/python -m unittest discover -s tests -vCogniRelay v1.4.6
CogniRelay v1.4.6 Release Notes
Release date: 2026-04-26
CogniRelay v1.4.6 is a focused MCP startup compatibility patch for standard
request metadata. It fixes clients that send MCP-reserved params._meta during
startup or request-method calls.
Highlights
tools/listnow accepts object-valuedparams._metaand returns the tool
catalog instead of failing withunexpected tools/list param.initialize,tools/list,tools/call, and runtime MCP help/reference
request methods now accept and ignore object-valuedparams._meta.- Actual tool
argumentsremain strict application payloads._metainside
tool arguments is not treated as request metadata. - The regression suite now replays the previously failing startup path:
initializewithclientInfo.title, followed bytools/listwith
params._meta.
Compatibility Notes
- Supported MCP protocol versions remain
2025-06-18and2025-11-25. clientInfoimplementation metadata compatibility from v1.4.5 is preserved.- Non-object
params._metafails deterministically with-32602 Invalid params. - Unknown non-metadata request params still fail deterministically.
- No MCP tool schema, HTTP route, schedule, graph, continuity, or UI response
shape changed. - The
GET /v1/capabilitiesversionfield remains the capability schema
version ("1").
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app tests tools
./.venv/bin/python -m unittest discover -s tests -vCogniRelay v1.4.5
CogniRelay v1.4.5 Release Notes
Release date: 2026-04-26
CogniRelay v1.4.5 is a focused MCP startup compatibility patch. It fixes
standards-compatible clients whose initialize request includes optional
clientInfo implementation metadata.
Highlights
initializenow accepts standard MCP implementation metadata fields under
clientInfo:title,description,websiteUrl, andicons.- The exact observed Codex startup payload with
clientInfo.titlenow succeeds. - The compatibility fix is not Codex-specific; it applies to the supported MCP
protocol versions2025-06-18and2025-11-25. - Immediate
tools/listafter successfulinitializeremains supported.
Compatibility Notes
- Top-level
initialize.paramsremains strict:protocolVersion,
capabilities, andclientInfo. clientInfo.nameremains required whenclientInfois present.- Unknown
clientInfofields still fail deterministically with
-32602 Invalid params. - No MCP tool schema, HTTP route, schedule, graph, continuity, or UI response
shape changed. - The
GET /v1/capabilitiesversionfield remains the capability schema
version ("1").
Verification
Release preparation should pass:
git diff --check
./.venv/bin/python -m ruff check app tests tools
./.venv/bin/python -m unittest discover -s tests -v