kenning-continuity 0.1.0__tar.gz

kenning_continuity-0.1.0/.gitignore

@@ -0,0 +1,81 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Type checking
+.mypy_cache/
+.pyright/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# uv
+uv.lock
+
+# Claude Code — local workspace config, machine-specific paths
+.claude/
+
+# Jujutsu VCS
+.jj/
+
+# Environment / credentials
+.env
+.env.*
+
+# Logs
+*.log
+
+# Neo4j local data
+neo4j/
+data/
+plugins/
+
+# ── Informal work: never published ────────────────────────────────────────
+#
+# Scratchpads, validation data, mock data, working notes, and the frame-to-frame
+# exchanges that produced the design. None of it belongs on Kenning AI's GitHub
+# presence or on PyPI. It is remembered in the substrates instead — the agent's
+# ESSG and the author's experience graph — which is what those are for.
+#
+# `.work/` is the rule in its structural form. The named entries below are a
+# denylist, and a denylist only holds if someone remembers to extend it: on
+# 2026-08-25 three rumination documents were created in `docs/design/`, which was
+# not on the list, and shipped to PyPI carrying 147 name occurrences. A file born
+# in `.work/` inherits the rule from its location and needs nobody to remember.
+#
+# `docs/` publishes only the MODEL — `docs/design/ontology/`, which the code is
+# built from. Reasoning about the model is not the model.
+
+.work/
+CLAUDE.md
+*.mermaid
+SPEC.md
+TEMPORAL.md
+
+# OS cruft
+.DS_Store
+**/.DS_Store

kenning_continuity-0.1.0/.release-notes/v0.1.0.md

@@ -0,0 +1,91 @@
+# v0.1.0 — Kenning Continuity
+
+First release. An MCP server that lets LLM agents accumulate organizational
+knowledge across sessions, scoped by domain, backed by Neo4j — with every
+structural invariant enforced by a tool rather than requested in an
+instruction.
+
+## What it is
+
+Two layers, and the separation between them is the design.
+
+**A process layer**, immutable: `Person → Session` within `Domain → Session`.
+`NEXT_SESSION` always points forward in time because the tool will not write it
+otherwise. Membership in this layer is the capacity to hold possible futures
+and measure them toward actualization; nothing here is a referent.
+
+**A knowledge layer**, append-only: 11 ontological types, 7 sub-labels arranged
+as a lattice, 13 connection types, every node marked `:Knowledge`. Changing what
+is known creates a new chain node linked by `EVOLVED_FROM`. Nothing is
+overwritten, ever.
+
+23 tools: 4 process, 6 knowledge mutation, 5 query, 2 taxonomy, 6 graph
+analytics. No raw Cypher write is exposed, so the graph cannot be corrupted by
+a model that decides to try.
+
+## Why it does not degrade as it fills
+
+Accumulating memory systems tend to fail in one of two ways: they confabulate
+from the first day, because nothing separates what was observed from what a
+model inferred while trying to be helpful; or they survive the demo and rot
+under mass, because every write is an unconstrained append.
+
+Four commitments answer that, and each is structural rather than advisory.
+
+**Nothing is overwritten.** There is no `update_knowledge` and no
+`retype_knowledge`, by design. The prior understanding stays readable and
+attributable. Being wrong earlier is a fact about the record, not something to
+erase from it.
+
+**Every claim reaches its author in two hops.** An entity is discovered by a
+`Session`; a `Session` is directed by a `Person`. Both edges are written by
+tools that refuse to run without a real director, so *who said this, when, and
+toward what purpose* is always answerable — because no code path creates
+knowledge without it.
+
+**Identity is never inferred from a string.** Seventeen nodes sharing a name
+across eleven domains are seventeen acts of reference, correctly distinct.
+Claiming two are one person is something someone does, in a session, recorded
+as a `REFERENT_CLAIM` that can carry `distinct` — because a system with nowhere
+to record *no* re-asks the same question forever.
+
+**Structure carries facts; properties do not duplicate them.** A knowledge
+entity holds no `domain` property. It is placed in one by the session that
+discovered it and reached from there by a walk, so the two can never disagree.
+
+There is no `confidence` field, deliberately. Someone's confidence on an
+occasion is a fact about their experience and does not transmit. What such
+scores reach for is carried by edges any reader can adjudicate from their own
+frame: `VALIDATION`, `INVALIDATING`, and a `Challenge` with no paired
+`Solution`.
+
+## The model leads
+
+`docs/design/ontology/v0.1.0.tql` is the source the implementation is built
+from, authored in TypeQL and validated against a live TypeDB server before any
+Python was written. Where the code and the model disagree, the model wins and
+the code is the defect. `docs/design/ontology/README.md` documents the build
+loop and every place the Neo4j representation diverges from the model, with the
+reason — a divergence not in that table is a bug, not a decision.
+
+## Licensing and attribution
+
+Apache-2.0. Use it, modify it, run it in production, commercially or otherwise.
+
+The work here is the ontology — the type lattice, resolution by walk, epistemic
+standing placed in edges, and the principle that every invariant lives in a
+tool. That is given away freely; Apache-2.0 asks only that attribution travel
+with it. The Kenning AI name is not part of the grant (§6); `TRADEMARKS.md`
+says what needs no permission, which is nearly everything.
+
+## Prior art in this codebase
+
+The implementation is not new code. It has run in production at enterprise
+scale — 37 domains, 376 sessions, 3,000+ knowledge entities over four months of
+daily use — and the ontology it enforces was revised against measurements of
+that graph rather than against argument. This is its first public release, not
+its first line.
+
+## Requires
+
+Python 3.10+ and a Neo4j 5.x instance. `pip install kenning-continuity`.