Knowledge System
Knowledge System is a local foundation for human-owned, agent-assisted Markdown collections. Markdown is the durable authority. The package inspects and validates collections, resolves stable references, evaluates FLAP and research profiles, computes trust-domain propagation, and applies reviewed changes through compare-and-swap mutation plans.
The package does not provide a database, embedding index, RAG service, MCP server, Obsidian plugin, or credential store. Projection records are contracts for later derived systems; they are not a second authority.
Install
The repository uses uv:
uv sync --all-groups
uv run kn --help
Runtime dependencies are Pydantic, ruamel.yaml, Typer, Loguru, Platformdirs, and typing-extensions.
Collection basics
A managed collection can contain collection.yaml, profiles.lock.yaml, and retired-ids.yaml. A directory without a manifest is still inspectable as generic Markdown, but its notes do not gain durable collection identity or profile semantics.
Registered notes use readable, collection-scoped identities:
---
id: stable-identities-survive-moves
profiles: [research@1]
created_by: human:kyle
origin: human
review:
status: unreviewed
research_kind: concept
research_depth: studied
sources: [source-version:identity-paper/v1]
---
Canonical references use note:<collection>/<id> and optional block selectors such as note:architecture/stable-identities-survive-moves#^claim.
Safe local changes
kn register and kn mutation plan produce an immutable plan before writing. kn mutation apply treats serialized plans as hostile: it verifies the plan digest, collection snapshot, authorization inputs, file hashes, identity reservations, semantic results, and an optional Git revision before any write. The CLI authenticates the current OS account as its local-filesystem principal; actor and task remain independent attribution. A stale precondition exits with code 3 and performs no writes.
See usage, reference, and design decisions for the complete local-core contract.
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 knowledge_system-0.0.1.tar.gz.
File metadata
- Download URL: knowledge_system-0.0.1.tar.gz
- Upload date:
- Size: 56.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
93a0a04aa58586505db9eb561737ee35b526951eb8620d4e0fcab9958c5ca16b
|
|
| MD5 |
5014f64179ffd4f55f183fbbe6aa9ad7
|
|
| BLAKE2b-256 |
abd1837ebc8f479d24636b95f9b6af45e70c1dfbf6894d0998a7dce6c3484888
|
Provenance
The following attestation bundles were made for knowledge_system-0.0.1.tar.gz:
Publisher:
release-python.yml on 56kyle/knowledge-system
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
knowledge_system-0.0.1.tar.gz -
Subject digest:
93a0a04aa58586505db9eb561737ee35b526951eb8620d4e0fcab9958c5ca16b - Sigstore transparency entry: 2441095367
- Sigstore integration time:
-
Permalink:
56kyle/knowledge-system@09ea2903120344e7e0ab07fc7969e4e9aa67fdf6 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/56kyle
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@09ea2903120344e7e0ab07fc7969e4e9aa67fdf6 -
Trigger Event:
push
-
Statement type:
File details
Details for the file knowledge_system-0.0.1-py3-none-any.whl.
File metadata
- Download URL: knowledge_system-0.0.1-py3-none-any.whl
- Upload date:
- Size: 64.1 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 |
9cbfb571d12bbc6029511590153e78e666cefa86c93208218a025efdbf621040
|
|
| MD5 |
4b4c6aa9543ddcf9ddd7bb9ae4d65874
|
|
| BLAKE2b-256 |
258ea807897d80d4b3fda057b287fcd4bdc70fc20f12c4e8e9bd7211c092a49a
|
Provenance
The following attestation bundles were made for knowledge_system-0.0.1-py3-none-any.whl:
Publisher:
release-python.yml on 56kyle/knowledge-system
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
knowledge_system-0.0.1-py3-none-any.whl -
Subject digest:
9cbfb571d12bbc6029511590153e78e666cefa86c93208218a025efdbf621040 - Sigstore transparency entry: 2441095841
- Sigstore integration time:
-
Permalink:
56kyle/knowledge-system@09ea2903120344e7e0ab07fc7969e4e9aa67fdf6 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/56kyle
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@09ea2903120344e7e0ab07fc7969e4e9aa67fdf6 -
Trigger Event:
push
-
Statement type:
