diff --git a/.custodian-brief.md b/.custodian-brief.md index f7f5fa3..65850ac 100644 --- a/.custodian-brief.md +++ b/.custodian-brief.md @@ -2,24 +2,96 @@ # Custodian Brief — kontextual-engine **Domain:** markitect -**Last synced:** 2026-05-05 08:58 UTC +**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 -### Durable Persistence Foundation +### Knowledge Operations Architecture Rebase Progress: 0/8 done | workstream_id: `e177f2dc-a2a0-41a4-b5cd-82e8f9f12f34` **Open tasks:** -- · Finalize persistence boundary and ADR `6b665ab1` -- · Complete repository contract semantics `eed4f0b5` -- · Design durable schema and migrations `7f34e36f` -- · Implement SQLite repository backend `6d20a457` -- · Persist artifact evolution `e4e6f188` -- · Add import/export and smoke verification `ea7313ce` -- · Add context and phase-memory reference hooks `965738a5` +- · 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)