Skip to content

Plan / Interface amendment: resolve mecatui remote endpoints decisions and add remote commands - #2053

Merged
tgrunnagle merged 2 commits into
mainfrom
plan/mecatui-remote-endpoints-decisions
Oct 1, 2026
Merged

tgrunnagle merged 2 commits into
mainfrom
plan/mecatui-remote-endpoints-decisions

Conversation

@tgrunnagle

@tgrunnagle tgrunnagle commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Stage: Plan / Interface amendment to #2049 (merged as 92683cb88).

/plan-orchestrate stopped at its entry gate because the merged plan still had three unchecked human decisions. This PR resolves them and adds one scope item the directing human requested.

Resolved decisions (directing human accepted all three recommendations)

  • Settings home: remote: lives in the strict, client-owned ~/.config/mecatui/settings.yaml, not the shared ~/.config/mecatl/settings.yaml.
  • Kind fixture profile: kind-connect and kind-login pass profile flags against the normal client root and write no settings file; destroy/reset run a best-effort mecatui logout first.
  • Endpoint name grammar: ^[a-z][a-z0-9-]{0,62}$; sessions and debug reserved; exact name match wins over host interpretation.

Text that pointed at "the settings-home decision" and "the endpoint-name decision" now names the concrete file and pattern.

Added: mecatui remote commands (new Scenario 6, AC6.1–AC6.5)

The directing human asked for CLI commands to configure endpoints. The grammar below is the agent's proposal; please review it — merging approves it.

  • mecatui remote add NAME RESOURCE_URL [--grpc-target] [--tls-ca] [--private-issuer --discovery-ca] [--default] — same profile flags and pairing rule as connect; relative CA paths stored absolute; CA must be a readable PEM file; duplicate name is an error.
  • mecatui remote list — name, resource, gRPC target, discovery policy, default marker; no network, no credentials.
  • mecatui remote remove NAME — deletes the entry, clears a matching default, does not log out (prints the mecatui logout command).
  • mecatui remote default NAME / --clear.
  • Writes follow ADR 0345 settings-mutation rules: in-place AST edit preserving comments and other keys, strict full-document validation, refuse to edit an already-invalid file, stale-write detection, temp-file + rename, 0600 file / 0700 dir on create.

The "mecatui remote add/list/remove" out-of-scope row is removed; editing an entry in place or logging out on remove is now listed as out of scope. Definition of done item 4 now covers the remote commands in user docs and the kind README. The kind tasks themselves still use flags.

Status moves draft → proposed; merging this PR is the approval event. ACs 1.1–5.4 and their verify lines are unchanged.

Verification

  • check-acceptance-plan.sh docs/acceptance/mecatui-remote-endpoints.md — passed (28 ACs with verify coverage; all human decisions resolved and recorded).
  • task docs — exit 0.

Implementation has not started; /plan-orchestrate will re-run from the merged commit.

Relates to #2049

🤖 Generated with Claude Code

Record the directing human's acceptance of the three open recommendations:
the remote: block lives in ~/.config/mecatui/settings.yaml, the kind
fixture passes profile flags with logout on destroy/reset, and endpoint
names match ^[a-z][a-z0-9-]{0,62}$ with sessions and debug reserved.
Replace decision-referencing contract text with the concrete choices and
move the plan from draft to proposed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The directing human asked for CLI commands that configure endpoints in
the client settings file. Add Scenario 6 and its interface: mecatui
remote add/list/remove/default, editing ~/.config/mecatui/settings.yaml
in place under the ADR 0345 settings-mutation rules, with no network,
registry, or credential side effects. Drop the matching out-of-scope row.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tgrunnagle tgrunnagle changed the title Plan / Interface amendment: resolve mecatui remote endpoints human decisions Plan / Interface amendment: resolve mecatui remote endpoints decisions and add remote commands Oct 1, 2026
@tgrunnagle
tgrunnagle merged commit 160d9f0 into main Oct 1, 2026
29 checks passed
@tgrunnagle
tgrunnagle deleted the plan/mecatui-remote-endpoints-decisions branch October 1, 2026 13:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants