Task 03: Explain creator-session default

Acceptance

The current_task option displays as Creating session profile and explains effective model/options inheritance, precedence, cost, and exclusions.
Task-mode and external-mode MCP descriptions accurately state their different session-context behavior without changing the public input schema.
Public task documentation matches the shipped setting and fallback chain.

Verification

(cd apps && pnpm install --frozen-lockfile && pnpm --filter @kandev/web test -- components/settings/mcp-task-agent-profile-default-settings.test.tsx && pnpm --filter @kandev/web i18n:check)
(cd apps/backend && go test ./internal/mcp/server)
(node --test scripts/validate-public-docs.test.mjs)
(node scripts/validate-public-docs.mjs)

Files likely touched

apps/backend/internal/mcp/server/server.go
apps/backend/internal/mcp/server/server_test.go
apps/backend/internal/mcp/server/handlers_test.go
apps/web/components/settings/mcp-task-agent-profile-default-settings.tsx
apps/web/components/settings/mcp-task-agent-profile-default-settings.test.tsx
apps/web/src/locales/*/settings.json
docs/public/tasks-and-workflows.md

Dependencies

Task 02 fixes the exact behavior that this copy describes.

Parallelism

Sequential. Copy and contract assertions must describe the final resolution behavior from Task 02.

Inputs

Spec: What, API surface, Scenarios, Out of scope
Plan: MCP contract text, Task Actions setting, Public documentation
Mobile exemplar: apps/web/e2e/tests/task/mobile-mcp-task-agent-profile-default.spec.ts

Output contract

Report changed terminology, public docs type, locale updates, files changed, exact tests run, results, blockers, risks, and synchronized task/plan status.

Results

Updated the setting copy and MCP tool descriptions to explain verified creating-session inheritance, effective model/mode/options, precedence, cost risk, external fallback, and the cases that suppress runtime copying. The stored enum remains current_task, while the visible label is now Creating session profile. English, pseudo, Portuguese, and Simplified Chinese catalogs are synchronized, and the public task/workflow guide matches the behavior.

Files changed:

apps/backend/internal/mcp/server/server.go
apps/backend/internal/mcp/server/server_test.go
apps/backend/internal/mcp/server/handlers_test.go
apps/web/components/settings/mcp-task-agent-profile-default-settings.test.tsx
apps/web/src/locales/en/settings.json
apps/web/src/locales/pseudo/settings.json
apps/web/src/locales/pt-pt/settings.json
apps/web/src/locales/zh-cn/settings.json
docs/public/tasks-and-workflows.md

Verification:

pnpm --filter @kandev/web test -- components/settings/mcp-task-agent-profile-default-settings.test.tsx  PASS (4 tests)
pnpm --filter @kandev/web typecheck  PASS
pnpm --filter @kandev/web i18n:check  PASS (existing locale parity/orphan advisories only)
node --test scripts/validate-public-docs.test.mjs && node scripts/validate-public-docs.mjs  PASS
rtk go test ./internal/mcp/server -count=1  PASS

3.4 KiB Raw Blame History