kontextual-engine/.custodian-brief.md

Custodian Brief — kontextual-engine

Domain: markitect
Last synced: 2026-05-05 16:18 UTC
State Hub: http://127.0.0.1:8000 (adjust if running on a remote machine)

Active Workstreams

Knowledge Operations Architecture Rebase

Progress: 0/8 done | workstream_id: e177f2dc-a2a0-41a4-b5cd-82e8f9f12f34

Open tasks:

• · Reconcile implementation baseline with V0.2 vision 6b665ab1
• · Define canonical asset identity and representation model eed4f0b5
• · Define actor permission policy and audit baseline 7f34e36f
• · Define provenance lineage versioning and derived artifact model 6d20a457
• · Define retrieval architecture and quality KPIs e4e6f188
• · Publish roadmap traceability and update scope docs ea7313ce
• · Define agent-safe operation catalog and review gates 965738a5
• … and 1 more open tasks

Asset Registry Governance And Durable State

Progress: 0/7 done | workstream_id: 231a7794-aa3b-4763-a556-80b4cea731c8

Open tasks:

• · Implement stable asset identity and source references 7d61a11c
• · Represent source normalized and derived asset forms cd0a2b0a
• · Implement metadata classification lifecycle and schema validation b06c5124
• · Implement actor authorization and policy baseline c86e24ee
• · Implement audit events correlation IDs and structured errors 3d2e98a1
• · Implement durable SQLite repository for registry state de155d02
• · Implement versioning change history conflict and idempotency semantics 5288b136

Multi-Format Ingestion And Normalization

Progress: 0/7 done | workstream_id: 270c83c0-eaed-4143-99d0-bb3fcfd23758

Open tasks:

• · Implement ingestion job model status and retry surface 8e5e514a
• · Implement connector and extractor contracts 3eafdab5
• · Implement local file and directory ingestion d3e3d4d2
• · Implement text and markdown normalization via markitect-tool adapter 63bf2f7e
• · Implement PDF office document and dataset baseline adapters 04d7c4b0
• · Extract structural elements into common normalized representation 7421bc87
• · Validate ingestion output quarantine failures and preserve provenance 07b32021

Governed Retrieval And Context Graph

Progress: 0/7 done | workstream_id: 64352515-9677-46bb-909a-9e2db4915dc7

Open tasks:

• · Implement query contracts pagination sorting and result envelopes 5a1b0661
• · Implement lexical search over normalized content 5ec90dcb
• · Implement metadata lifecycle and source-context filters 9e7d0a5c
• · Implement contextual entity model and relationship retrieval b3358059
• · Enforce permission-aware retrieval and fail-closed semantics c6c93713
• · Return source-grounded snippets citations and explanation data 1a6d5a95
• · Capture retrieval feedback and KPI measurement hooks e17e2839

Traceable Transformations And Workflow Jobs

Progress: 0/7 done | workstream_id: 1b7a6b04-7879-4862-bb3e-817f7f20fc59

Open tasks:

• · Implement transformation operation registry ee2471b1
• · Implement transformation runs with parameters actors and policy context 1eac7b47
• · Persist derived artifacts and source lineage 837ad793
• · Implement workflow templates steps dependencies and preconditions 2c55c5dd
• · Implement job runner status retry resume and cancel behavior 5f4d6c88
• · Implement review gates human tasks and exception queues 5fae9005
• · Audit workflow and transformation operations 9e06aa46

Service API And Agent-Safe Operation

Progress: 0/7 done | workstream_id: 6e672b1a-2e57-489e-8516-cb75611d4354

Open tasks:

• · Implement versioned FastAPI service skeleton and health contracts bdb2380e
• · Expose asset metadata relationship audit and policy APIs a37e5ba3
• · Expose ingestion retrieval transformation and workflow APIs 7271b26d
• · Implement actor context delegation and authorization middleware 7becdec7
• · Implement bounded agent operation catalog fc9e1def
• · Implement context package API with policy constraints 9ff1d345
• · Implement dry-run review-gate and contract-test coverage bbbdec75

Observability Export And Enterprise Readiness

Progress: 0/7 done | workstream_id: 09d769a5-a3cf-4cdf-ae5e-b4ecf767f109

Open tasks:

• · Expose operational metrics events and job inspection ce6cfbc4
• · Implement administrative recovery actions 8f0ead65
• · Implement export packages manifests and integrity validation 54ed199f
• · Implement governance inspection and reporting hooks c62c5f36
• · Implement extension events webhooks and backend abstraction readiness f1713b41
• · Capture retrieval AI cost and quality signals 1d36035a
• · Add performance smoke tests and MVP compliance report 057c7bcf

---

MCP Orientation (when available)

If the state-hub MCP server is reachable, call: get_domain_summary("markitect") This provides richer cross-domain context. If the MCP call fails, use this file as your orientation source.