Carlos Florêncio
92 lines
3.4 KiB
Markdown
92 lines
3.4 KiB
Markdown
---
|
|
id: "03-explain-session-default"
|
|
title: "Explain creator-session default"
|
|
status: done
|
|
wave: 3
|
|
depends_on: ["02-creator-session-resolution"]
|
|
plan: "plan.md"
|
|
spec: "../../specs/tasks/requirements/mcp-task-agent-profile-default.md"
|
|
---
|
|
|
|
# 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
|
|
|
|
```bash
|
|
(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:
|
|
|
|
```text
|
|
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
|
|
```
|