Files
kontextual-engine/workplans/KONT-WP-0001-repo-foundation.md

90 lines
2.2 KiB
Markdown

---
id: KONT-WP-0001
type: workplan
title: "Repository Foundation And State Hub Integration"
domain: markitect
repo: kontextual-engine
status: done
owner: codex
topic_slug: markitect
created: "2026-05-03"
updated: "2026-05-05"
state_hub_workstream_id: "52ff9c49-edcf-4150-8895-c6b31f5aa075"
---
# KONT-WP-0001: Repository Foundation And State Hub Integration
## Purpose
Establish `kontextual-engine` as a properly scoped, State Hub connected
successor repo before implementation begins.
## F1.1 - Register repo with State Hub
```task
id: KONT-WP-0001-T001
status: done
priority: high
state_hub_task_id: "f11fbf85-6841-464d-b076-73811a161a8e"
```
Create or verify the State Hub repo record for `kontextual-engine` in the
`markitect` domain with the local host path `/home/worsch/kontextual-engine`.
## F1.2 - Add State Hub repo integration files
```task
id: KONT-WP-0001-T002
status: done
priority: high
state_hub_task_id: "7a56ea42-1690-4bd6-9640-29c3863717a6"
```
Add `CLAUDE.md`, `.custodian-brief.md`, `SCOPE.md`, `tpsc.yaml`, and
`docs/state-hub-integration.md` so future sessions can orient consistently.
## F1.3 - Establish authoritative workplan set
```task
id: KONT-WP-0001-T003
status: done
priority: high
state_hub_task_id: "950f43a4-e815-42b5-a167-eb48f0706d4d"
```
Create initial workplans for foundation, legacy scope extraction, and first
implementation slices using the ADR-001 file-backed convention.
## F1.4 - Run State Hub consistency sync
```task
id: KONT-WP-0001-T004
status: done
priority: high
state_hub_task_id: "6fefec5f-eff8-402a-ad87-bf4821468a3d"
```
From `/home/worsch/the-custodian/state-hub`, run:
```bash
make fix-consistency REPO=kontextual-engine
```
Verify the repo has no consistency failures after State Hub indexes the
workplan files.
## F1.5 - Decide initial implementation stack
```task
id: KONT-WP-0001-T005
status: done
priority: medium
state_hub_task_id: "616e0476-7b65-4079-b545-13e0fc9436f7"
```
Choose the first implementation stack, dependency manager, test command, and
service framework. Record the decision before adding application code.
Output: `docs/stack-decision.md`; executable scaffold added in `pyproject.toml`,
`src/kontextual_engine/`, and `tests/`.