diff --git a/.claude/rules/stack-and-commands.md b/.claude/rules/stack-and-commands.md index dc53ac6..f35aef1 100644 --- a/.claude/rules/stack-and-commands.md +++ b/.claude/rules/stack-and-commands.md @@ -1,19 +1,22 @@ ## Stack - -- **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 . ``` diff --git a/workplans/TELE-WP-0001-statehub-bootstrap.md b/workplans/TELE-WP-0001-statehub-bootstrap.md index c84085a..89116b5 100644 --- a/workplans/TELE-WP-0001-statehub-bootstrap.md +++ b/workplans/TELE-WP-0001-statehub-bootstrap.md @@ -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`: diff --git a/workplans/TELE-WP-0002-mcp-bridge-local-verification.md b/workplans/TELE-WP-0002-mcp-bridge-local-verification.md new file mode 100644 index 0000000..a30640e --- /dev/null +++ b/workplans/TELE-WP-0002-mcp-bridge-local-verification.md @@ -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.