fix: improve workspace context error messages #56

Merged

Snider merged 1 commit from fix/workspace-context-errors into main

2026-02-23 11:39:42 +00:00

Clotho commented

2026-02-23 11:30:07 +00:00

Member

Summary

Updated workspace_id error messages in 7 MCP tools to include actionable guidance and a documentation link
Affected tools: PlanCreate, PlanGet, PlanList, StateSet, StateGet, StateList, SessionStart
SessionStart message additionally mentions the plan_slug option for inferring workspace context
Marked DX-001 as resolved in TODO.md

Changes

All tools now return:

workspace_id is required. Ensure you have authenticated with a valid API key and started a session. See: https://host.uk.com/ai

SessionStart returns:

workspace_id is required. Ensure you have authenticated with a valid API key and started a session, or provide a valid plan_slug to infer workspace context. See: https://host.uk.com/ai

Test plan

Existing security tests pass (all assert assertStringContainsString('workspace_id is required', ...) — still satisfied)
Error messages now include actionable guidance and documentation link

Closes #28

🤖 Generated with Claude Code

## Summary - Updated `workspace_id` error messages in 7 MCP tools to include actionable guidance and a documentation link - Affected tools: `PlanCreate`, `PlanGet`, `PlanList`, `StateSet`, `StateGet`, `StateList`, `SessionStart` - `SessionStart` message additionally mentions the `plan_slug` option for inferring workspace context - Marked `DX-001` as resolved in `TODO.md` ## Changes All tools now return: ``` workspace_id is required. Ensure you have authenticated with a valid API key and started a session. See: https://host.uk.com/ai ``` `SessionStart` returns: ``` workspace_id is required. Ensure you have authenticated with a valid API key and started a session, or provide a valid plan_slug to infer workspace context. See: https://host.uk.com/ai ``` ## Test plan - [ ] Existing security tests pass (all assert `assertStringContainsString('workspace_id is required', ...)` — still satisfied) - [ ] Error messages now include actionable guidance and documentation link Closes #28 🤖 Generated with [Claude Code](https://claude.com/claude-code)

Clotho added 1 commit 2026-02-23 11:30:07 +00:00

fix: improve workspace context error messages (closes #28 )

CI / PHP 8.4 (pull_request) Failing after 1m39s

Details

CI / PHP 8.3 (pull_request) Failing after 1m42s

Details

6748e6cd84

Updated workspace_id error messages in all MCP tools to include
actionable guidance and a documentation link. Affected tools:
PlanCreate, PlanGet, PlanList, StateSet, StateGet, StateList,
SessionStart.

Resolves DX-001 from TODO.md.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>