makelore/.project-docs/30-worklog/tasks/20260929-code-back-entry-33d87a81.md

Task: Move Code return navigation into the coding workspace

Identity

• Task ID: 20260929-code-back-entry-33d87a81
• Mode: Feature
• Branch: codex/20260929-code-back-entry-33d87a81-code-back-entry
• Worktree: /Users/chillishark/Makelore 麦洛/.codex-worktrees/makelore/20260929-empty-work-merge-39c633d0
• Base commit: a77ddbd681
• Owner: codex
• Status: Ready for Integration

Scope

• Move the existing “编程 Code” module-home return entry from the project configuration sidebar into the Coding chat/workspace sidebar below the brand. Retain its /module-select target and the configuration page's own back action.

Intent And Constraints

• User first requested understanding only, confirmed the two-page interpretation, then explicitly approved implementation. Preserve existing light styling, projects, conversation drafts/history, module access and other module navigation. No live-app update, merge, push or deployment is requested for this new change.
• Reused the clean, completed prior merge checkout after releasing its ready task ownership; old branch/commits remain. Created a new branch at current main a77ddbd, then successfully claimed this new task and verified exact task/mode/worktree/branch/base/reservation. No source from occupied foreign worktrees adopted.

Project Context Loaded

• Task identity: as above, feature mode; ownership verified. Read active task and entry/memory index. Previously loaded positioning, current-state, decision-index, teacher ADR, architecture/domain, evidence, commitments and stale items are unchanged from 5aabaaf, verified by Git diff. Current AGENTS still requires existing light system, local project state and Main-owned APIs.
• Product/context: current main includes empty-work behavior, teacher voice/model controls and compact published shortcuts. This is a small navigation relocation within the existing sidebar; no new visual system is needed. Inspected screenshots, Sidebar, ModuleSwitcher, MainLayout, module route definitions, layout CSS and existing navigation tests.
• Peer scopes reviewed read-only. Active teacher-group-intro and child-language tasks have undefined scope, so coordination context is unknown; neither supplies a known dependency on module-return navigation. Existing teacher/UI tasks are ready. This task owns Sidebar navigation plus focused test/README updates only; no shared canonical docs.
• Relevant behavior: original “编程 Code” ModuleSwitcher navigates to /module-select, not a project reset. /chat uses the classroom sidebar; project configuration and nested resource pages use the generic sidebar. Retain the original target as the user confirmed.
• Gate: Passed. Plan: show the existing module-return control below the Code workspace brand, omit it on /project-config and nested configuration routes, keep a compact accessible layout, adjust the existing navigation regression, run typecheck/lint/build and focused UI verification, review and commit.

Outcome

• Reused the existing ModuleSwitcher beneath the brand in the /chat sidebar, retaining its compact arrow/text style, accessible return-home label and /module-select action. Project configuration and nested resource pages omit the entire sidebar header block, so no empty placeholder remains. Existing configuration back action, sidebar resizing/peek and other module controls are unchanged. README synchronized.

Verification

• pnpm 10.33.4 standard typecheck, changed-file ESLint and production Renderer/Main/Preload/utility build passed. Existing sidebar/peek/module gate and module-navigation unit coverage: 23 tests across four files passed.
• Extended one existing navigation scenario; isolated Electron E2E 1/1 passed. It checks Code return beneath the brand, no sidebar entry on configuration or plugin subpage, configuration back to chat, and collapsed-sidebar hover followed by real navigation to /module-select. Used an independent test profile/ports; no real user application or conversations were changed. Test command: corepack pnpm exec playwright test tests/e2e/main-navigation.spec.ts --grep 'opens remembered Code projects' --reporter=list.
• Inspected chat and configuration screenshots; delegated review also checked collapsed peek. Artifacts are under test-results/main-navigation-Makelore-m-9ce56-instead-of-project-settings/. Independent code review passed; no additional regression found. Whitespace and task-doc drift checks passed.

Follow-ups

• Source is ready for integration. Main, remote and the running temporary app were not updated by this new task.

Promotion Candidates

• Target: canonical classroom navigation when next integrated. Proposal: Code module-home return is visible below the chat sidebar brand and omitted from project configuration/resource sidebars; original configuration back remains. Evidence: explicit user confirmation, existing component reuse, actual Electron navigation and screenshots. No architecture or module-target change; no further product confirmation required.