coulomb/kontextual-engine
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
AI-first headless Knowledge/CMS/ECM engine.
104 commits 1 branch 0 tags 693 KiB
Find a file
tegwick 424f058a98
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 1s
Details
Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) 
Sync AGENTS.md, CLAUDE.md, and .claude/rules from updated project_rules
templates: workplan-first session protocol, legacy terminology footnote,
and GET /workplans/ examples.
2026-07-08 14:50:29 +02:00
.claude/rules Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) 2026-07-08 14:50:29 +02:00
.forgejo/workflows Add Forgejo CI smoke workflow (enablement template) 2026-07-08 12:33:59 +02:00
docs feat(memory): define external adapter boundaries 2026-05-15 11:23:50 +02:00
examples query parsing and diagnostics 2026-05-14 02:20:17 +02:00
registry Draft capability entry (reuse-surface REUSE-WP-0017-T04, cohort 2) 2026-07-06 19:41:37 +02:00
src/kontextual_engine feat(memory): define external adapter boundaries 2026-05-15 11:23:50 +02:00
tests feat(memory): define external adapter boundaries 2026-05-15 11:23:50 +02:00
wiki Major overhaul of requirements for refined INTENT.md 2026-05-05 18:04:51 +02:00
workplans Normalize agent instructions and workplan frontmatter (STATE-WP-0067) 2026-06-22 23:16:27 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-07-03 18:46:33 +02:00
.gitignore Initial commit 2026-05-03 16:48:22 +00:00
.repo-classification.yaml Add .repo-classification.yaml (CUST-WP-0050 T11 agent first-pass) 2026-06-22 17:47:38 +02:00
AGENTS.md Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) 2026-07-08 14:50:29 +02:00
CHANGELOG.md Release readiness polish 2026-05-14 03:29:05 +02:00
CLAUDE.md Add credential routing instructions for all agent runtimes 2026-06-18 22:48:38 +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 Release readiness polish 2026-05-14 03:29:05 +02:00
README.md Release readiness polish 2026-05-14 03:29:05 +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

README.md

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/first-release-readiness.md
  • docs/release-runbook-0.1.0.md
  • docs/release-security-configuration-storage-review.md
  • CHANGELOG.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.