AI-first headless Knowledge/CMS/ECM engine.
Find a file
tegwick fa3aa2e5b0 chore(consistency): sync task status from DB [auto]
Updated by fix-consistency on 2026-05-08:
  - update .custodian-brief.md for kontextual-engine
2026-05-08 17:40:44 +02:00
docs Scoped CMIS workspace folders with create, list, parent, path lookup, delete, and delete-tree behavior 2026-05-08 16:47:30 +02:00
examples CMIS layer into an honest CMIS 1.1 2026-05-07 04:11:09 +02:00
src/kontextual_engine Scoped CMIS workspace folders with create, list, parent, path lookup, delete, and delete-tree behavior 2026-05-08 16:47:30 +02:00
tests Scoped CMIS workspace folders with create, list, parent, path lookup, delete, and delete-tree behavior 2026-05-08 16:47:30 +02:00
wiki Major overhaul of requirements for refined INTENT.md 2026-05-05 18:04:51 +02:00
workplans Scoped CMIS workspace folders with create, list, parent, path lookup, delete, and delete-tree behavior 2026-05-08 16:47:30 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-05-08 17:40:44 +02:00
.gitignore Initial commit 2026-05-03 16:48:22 +00:00
CLAUDE.md Finish repository foundation workplan 2026-05-05 00:53:28 +02:00
INTENT.md Major overhaul of requirements for refined INTENT.md 2026-05-05 18:04:51 +02:00
LICENSE Initial commit 2026-05-03 16:48:22 +00:00
pyproject.toml content-addressed blob storage: blob_storage.py, memory, local, and S3 adapters 2026-05-07 03:51:25 +02:00
README.md Governed asset registry slice with asset creation, representations, metadata, lifecycle transitions, policy authorization, fail-closed denial, audit events, and version records 2026-05-06 00:35:30 +02:00
SCOPE.md Generated new set of workplans 2026-05-05 18:45:09 +02:00
tpsc.yaml State-hub connect and initial workplans 2026-05-03 20:43:50 +02:00

kontextual-engine

Headless knowledge operations engine for turning heterogeneous information assets into persistent, contextual, governed, retrievable, transformable, and agent-operable knowledge.

Start here:

  • INTENT.md
  • wiki/ProductRequirementsDocument.md
  • wiki/FunctionalRequirementsSpecification.md
  • wiki/kontextual-engine_scope_research_md_bundle/
  • SCOPE.md
  • docs/knowledge-operations-roadmap.md
  • docs/architecture-blueprint.md
  • docs/architecture-core-implementation.md
  • docs/asset-registry-implementation.md
  • docs/stack-decision.md
  • docs/markitect-main-scope-assessment.md
  • docs/markitect-tool-reuse-boundary.md
  • docs/markitect-tool-integration-usecases.md
  • docs/markitect-tool-capacity-risks.md
  • examples/markitect-tool-contract/
  • docs/test-performance-monitoring.md
  • docs/phase-memory-boundary.md
  • docs/system-layer-extraction-inventory.md
  • docs/system-layer-migration-backlog.md
  • docs/service-api-boundary.md
  • workplans/

Development

This repo uses Python 3.12+, setuptools, a src/ package layout, and pytest.

python3 -m pytest

Pytest records a compact rolling performance history under .pytest_cache/kontextual/performance-history.json; see docs/test-performance-monitoring.md.

The first runtime slice implements artifacts, collections, relationships, in-memory storage, ingestion adapters, query, workflow run manifests, and agent-facing context packages. The current roadmap re-scopes the next work around the V0.2 knowledge operations vision: governed asset identity, multi-format ingestion, retrieval, traceable transformations, workflows, service APIs, agent-safe operation, observability, and export.