fix: mcp_get_control_plane_guide must accept org/repo after #530 guard #588

New Issue

2026-07-09T12:16:52-05:00

jcwalker3 commented

2026-07-09 12:16:52 -05:00

Problem

Regression / incomplete fix for #530.

Live failure during controller triage:

mcp_get_control_plane_guide(remote="prgs")

failed with remote/repo guard (#530):

MCP-resolved repository: Scaled-Tech-Consulting/Timesheet
local git remote: https://gitea.prgs.cc/Scaled-Tech-Consulting/Gitea-Tools.git
remediation text: pass explicit org= and repo=
schema gap: mcp_get_control_plane_guide only accepted remote and host — no org/repo parameters — so the suggested recovery was impossible through the tool schema

Scope

Add org and repo optional parameters to mcp_get_control_plane_guide (schema must match remediation).
Safe context: when bare remote defaults mismatch the local git remote, align the guide target to the local org/repo so bootstrap still works in a Gitea-Tools worktree.
Keep mutation tools fail-closed on bare mismatch (#530 guard preserved).
Remediation text must only recommend parameters the guide (and other tools) actually accept.
Regression tests for explicit Gitea-Tools, bare local alignment, wrong-default fail-closed guidance, schema/remediation consistency.

Prior work

#530 / PR #555 landed the mismatch guard but left the guide unusable under bare remote=prgs in this repo.

Acceptance

mcp_get_control_plane_guide(remote="prgs", org=..., repo=Gitea-Tools) succeeds and reports that repository
Bare guide in a Gitea-Tools worktree does not stay on Timesheet
Wrong bare default still fails closed for mutation tools
Every recovery suggestion matches the actual tool schema

## Problem Regression / incomplete fix for #530. Live failure during controller triage: ```text mcp_get_control_plane_guide(remote="prgs") ``` failed with remote/repo guard (#530): * MCP-resolved repository: `Scaled-Tech-Consulting/Timesheet` * local git remote: `https://gitea.prgs.cc/Scaled-Tech-Consulting/Gitea-Tools.git` * remediation text: pass explicit `org=` and `repo=` * **schema gap:** `mcp_get_control_plane_guide` only accepted `remote` and `host` — no `org`/`repo` parameters — so the suggested recovery was impossible through the tool schema ## Scope 1. Add `org` and `repo` optional parameters to `mcp_get_control_plane_guide` (schema must match remediation). 2. Safe context: when bare remote defaults mismatch the local git remote, align the guide target to the local org/repo so bootstrap still works in a Gitea-Tools worktree. 3. Keep mutation tools fail-closed on bare mismatch (#530 guard preserved). 4. Remediation text must only recommend parameters the guide (and other tools) actually accept. 5. Regression tests for explicit Gitea-Tools, bare local alignment, wrong-default fail-closed guidance, schema/remediation consistency. ## Prior work * #530 / PR #555 landed the mismatch guard but left the guide unusable under bare `remote=prgs` in this repo. ## Acceptance - [ ] `mcp_get_control_plane_guide(remote="prgs", org=..., repo=Gitea-Tools)` succeeds and reports that repository - [ ] Bare guide in a Gitea-Tools worktree does not stay on Timesheet - [ ] Wrong bare default still fails closed for mutation tools - [ ] Every recovery suggestion matches the actual tool schema

jcwalker3 referenced this issue from a commit

2026-07-09 12:17:37 -05:00

fix: control-plane guide org/repo params and local repo alignment (#588)

jcwalker3 added the status:in-progress label 2026-07-09 12:18:05 -05:00

jcwalker3 commented

2026-07-09 12:18:06 -05:00

Issue claim heartbeat

kind: claim
issue: fix: mcp_get_control_plane_guide must accept org/repo after #530 guard (#588)
branch: fix/issue-588-guide-repo-guard
phase: claimed
profile: prgs-author
pr: none
blocker: none
next_action: create worktree and begin implementation

**Issue claim heartbeat** - kind: claim - issue: #588 - branch: fix/issue-588-guide-repo-guard - phase: claimed - profile: prgs-author - pr: none - blocker: none - next_action: create worktree and begin implementation

jcwalker3 referenced a pull request that will close this issue

2026-07-09 12:18:58 -05:00

fix: control-plane guide org/repo params after #530 guard (Closes #588) #589

jcwalker3 added status:pr-open and removed status:in-progress labels 2026-07-09 12:19:00 -05:00

sysadmin referenced this issue

2026-07-09 12:40:43 -05:00

fix: control-plane guide org/repo params after #530 guard (Closes #588) #589

sysadmin referenced this issue

2026-07-09 12:41:24 -05:00

fix: control-plane guide org/repo params after #530 guard (Closes #588) #589

sysadmin referenced this issue

2026-07-09 12:41:37 -05:00