Complete State Hub bootstrap workplans (WP-0001)

- Review integration files; fill SCOPE where templated
- Document dev workflow in stack-and-commands.md
- Seed WP-0002 implementation workplan; mark bootstrap finished
- Hub sync via fix-consistency
This commit is contained in:
2026-06-22 23:35:20 +02:00
parent 9f64d6926a
commit f061364951
3 changed files with 55 additions and 14 deletions

View File

@@ -1,19 +1,22 @@
## Stack
<!-- TODO: Fill in language, frameworks, and key dependencies -->
- **Language:**
- **Key deps:**
- **Language:** Python (FastAPI MCP bridge) + Ansible/Helm/K8s deploy assets
- **Key deps:** FastAPI, uvicorn, httpx; kube-prometheus-stack, Loki, Promtail
## Dev Commands
```bash
# TODO: Fill in the standard commands for this repo
# Deploy observability stack (from repo root)
cd ansible && ansible-playbook -i inventories/local.ini playbook.yml
# Install dependencies
# MCP bridge (local)
cd mcp-telemetry-bridge
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8080
# Run tests
# Lint / type check
# Build / package (if applicable)
# Smoke (requires cluster access)
kubectl get pods -n monitoring
kubectl port-forward -n mcp svc/mcp-telemetry-bridge 8080:80
curl http://localhost:8080/healthz
curl http://localhost:8080/mcp/schema | jq .
```

View File

@@ -4,11 +4,12 @@ type: workplan
title: "Bootstrap State Hub integration"
domain: infotech
repo: tele-mcp
status: ready
status: finished
owner: codex
topic_slug: custodian
created: "2026-06-22"
updated: "2026-06-22"
state_hub_workstream_id: "f8a00337-b34e-40a1-a720-ce968d8a575e"
---
# Bootstrap State Hub integration
@@ -19,10 +20,13 @@ updated: "2026-06-22"
```task
id: TELE-WP-0001-T01
status: todo
status: done
priority: high
state_hub_task_id: "b91614b5-1524-4871-8f9e-532be354ce9f"
```
Result 2026-06-22: INTENT.md, SCOPE.md, AGENTS.md reviewed.
Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
Replace generated placeholders with repo-specific facts where needed.
@@ -30,10 +34,13 @@ Replace generated placeholders with repo-specific facts where needed.
```task
id: TELE-WP-0001-T02
status: todo
status: done
priority: high
state_hub_task_id: "ede18111-be6a-4191-b9ef-752fa99ec6c6"
```
Result 2026-06-22: Documented Ansible/kubectl/uvicorn workflow.
Identify the repo's install, test, lint, build, and run commands. Add or refine
those commands in the agent instructions so future coding sessions can verify
changes confidently.
@@ -42,10 +49,13 @@ changes confidently.
```task
id: TELE-WP-0001-T03
status: todo
status: done
priority: medium
state_hub_task_id: "ff0d4282-b831-4b2a-a1d7-24b67286acab"
```
Result 2026-06-22: Created TELE-WP-0002.
Create the first implementation workplan for the repository's most important
next change. After workplan file updates, run from `~/state-hub`:

View File

@@ -0,0 +1,28 @@
---
id: TELE-WP-0002
type: workplan
title: "MCP bridge local verification loop"
domain: infotech
repo: tele-mcp
status: ready
owner: codex
topic_slug: custodian
created: "2026-06-22"
updated: "2026-06-22"
state_hub_workstream_id: "c617a044-bf57-4671-9afd-0112e7f462fd"
---
# MCP bridge local verification loop
Harden the local dev/test loop for `mcp-telemetry-bridge` independent of full cluster deploy.
## Local verification harness
```task
id: TELE-WP-0002-T01
status: todo
priority: high
state_hub_task_id: "7bad3ebf-f42c-4069-9c13-28bcf231f6f9"
```
Add documented local run path, health/schema smoke tests, and agent-oriented quickstart in README.