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 ## Stack
<!-- TODO: Fill in language, frameworks, and key dependencies --> - **Language:** Python (FastAPI MCP bridge) + Ansible/Helm/K8s deploy assets
- **Language:** - **Key deps:** FastAPI, uvicorn, httpx; kube-prometheus-stack, Loki, Promtail
- **Key deps:**
## Dev Commands ## Dev Commands
```bash ```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 # Smoke (requires cluster access)
kubectl get pods -n monitoring
# Lint / type check kubectl port-forward -n mcp svc/mcp-telemetry-bridge 8080:80
curl http://localhost:8080/healthz
# Build / package (if applicable) curl http://localhost:8080/mcp/schema | jq .
``` ```

View File

@@ -4,11 +4,12 @@ type: workplan
title: "Bootstrap State Hub integration" title: "Bootstrap State Hub integration"
domain: infotech domain: infotech
repo: tele-mcp repo: tele-mcp
status: ready status: finished
owner: codex owner: codex
topic_slug: custodian topic_slug: custodian
created: "2026-06-22" created: "2026-06-22"
updated: "2026-06-22" updated: "2026-06-22"
state_hub_workstream_id: "f8a00337-b34e-40a1-a720-ce968d8a575e"
--- ---
# Bootstrap State Hub integration # Bootstrap State Hub integration
@@ -19,10 +20,13 @@ updated: "2026-06-22"
```task ```task
id: TELE-WP-0001-T01 id: TELE-WP-0001-T01
status: todo status: done
priority: high 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`. Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
Replace generated placeholders with repo-specific facts where needed. Replace generated placeholders with repo-specific facts where needed.
@@ -30,10 +34,13 @@ Replace generated placeholders with repo-specific facts where needed.
```task ```task
id: TELE-WP-0001-T02 id: TELE-WP-0001-T02
status: todo status: done
priority: high 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 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 those commands in the agent instructions so future coding sessions can verify
changes confidently. changes confidently.
@@ -42,10 +49,13 @@ changes confidently.
```task ```task
id: TELE-WP-0001-T03 id: TELE-WP-0001-T03
status: todo status: done
priority: medium 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 Create the first implementation workplan for the repository's most important
next change. After workplan file updates, run from `~/state-hub`: 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.