fix(agents): open cards from home and align sidebar navigation

.project-docs/30-worklog/tasks/20261012-agent-entry-nav-a13e56c9.md

@@ -0,0 +1,86 @@
+# Task: Show Agent cards on entry and align sidebar navigation
+
+## Identity
+
+- Task ID: 20261012-agent-entry-nav-a13e56c9
+- Mode: Feature
+- Branch: codex/20261012-agent-entry-nav-a13e56c9-agent-entry-nav
+- Worktree: /Users/chillishark/Makelore 麦洛/.codex-worktrees/makelore/20261012-agent-entry-nav-a13e56c9
+- Base commit: e5d79bf37a35f84a2b08cab0ad4d712b75fca358
+- Owner: codex
+- Status: Planning
+
+## Scope
+
+- Homepage Agents module entry opens My Agents cards before any individual Agent configuration/conversation.
+- Align the Agents sidebar return-home arrow and collapse control in one top row, matching the user's reference.
+- Update the latest local temporary application from this isolated source and preserve its existing profile.
+
+## Intent And Constraints
+
+- Keep Chinese product language. Current user instruction authorizes both implementation and continued trial update.
+- Do not clear account-scoped recent/pending recovery data, saved drafts, conversation history, selected model/resources, or backend policies. The card-list intent belongs to explicit entry, not every navigation/mount.
+- Preserve direct links, explicit card/config/chat actions, draft leave guards, authentication/module access and typed Host APIs.
+- Scope sidebar presentation to Agents; Code/Canvas/Robot navigation, native titlebar and account interactions stay compatible. Installed application and cloud services are outside scope.
+
+## Project Context Loaded
+
+Task context:
+- Task ID: 20261012-agent-entry-nav-a13e56c9
+- Mode: Feature
+- Branch: codex/20261012-agent-entry-nav-a13e56c9-agent-entry-nav
+- Worktree: /Users/chillishark/Makelore 麦洛/.codex-worktrees/makelore/20261012-agent-entry-nav-a13e56c9
+- Base commit: e5d79bf37a35f84a2b08cab0ad4d712b75fca358 (verified current temporary application source).
+- Ownership: bundled start succeeded; status JSON matched task/mode/absolute worktree/branch/base and planning status.
+- Other active local tasks: 35 peer owners; each task-record Scope / Intent And Constraints / Promotion Candidates read read-only.
+- Overlap: completed Agent homepage/config/trial tasks overlap but support explicit card-list entry. One child-language task scope remains undefined with no concrete dependency. No blocking semantic conflict; unrelated primary/canonical integration work remains untouched.
+
+Read:
+- AGENTS.md; 05-agent-entry/read-before-planning.md and memory-index.md; active task record; planning-gate requirements retained from prior task.
+- 00-brief/project-positioning.md and success-criteria.md; 20-architecture/community-collaboration.md; 30-worklog/current-state.md integrated snapshot.
+- 10-decisions/decision-index.md and task-relevant personal-cloud ADR recovery/navigation clauses; 20-architecture/system-overview.md; 40-domain/business-rules.md.
+- 50-evidence/evidence-index.md; 60-reflection/reflection-index.md; 80-commitments/commitments.md. Canonical content is unchanged from the prior context-loaded task; latest user refinements are authoritative for UI.
+
+Relevant understanding:
+- Project goal: approachable AI creation/use for students and creators; client does not introduce courses or own cloud authentication/billing authority.
+- Current integrated focus: unified module permissions/cloud capabilities and traditional Works login; October personal-Agent UI refinements are newer than integrated guided UI descriptions.
+- Active task: explicit module entry destination and Agents navigation-row layout, followed by a local trial update.
+- Constraints/decisions: Main owns credentials/network/recovery, Renderer uses typed APIs; recent and pending records survive restart and account isolation. User explicitly chooses card destinations; opening modules does not call a model.
+- Evidence/reflections/commitments: local fixture/navigation checks do not establish signed installed-client or paid-provider acceptance. Existing real-release commitments remain separate.
+- Likely modules: ModuleSelection/CloudAgents routing recovery, Sidebar/TitleBar/MainLayout/ModuleSwitcher, focused unit/layout/Electron tests and README.
+- Unknown/stale context: integrated old Agent trial/first-use layout is superseded by the current source and user. Native trial clicks have been intermittent; actual UI may need user navigation, and authentication must remain manual after restart.
+
+Gate result:
+- Passed.
+
+## Plan
+
+1. Add explicit card-list entry intent without erasing recovery data or changing individual Agent links.
+2. Put Agents return and collapse controls on the same row with accessible labels and keep other modules compatible.
+3. Verify scoped behavior/layout and production build, then update the exact temporary runtime after checking unsaved input.
+4. Record observed outcome, commit task result, normalize documentation-only runtime metadata and complete ownership.
+
+## Outcome
+
+- Homepage Agents and sidebar “我的智能体” now explicitly open the card list via `view=mine`; remembered conversations and pending operations are retained. Individual card actions, direct recovery and channel/shared links keep their existing behavior.
+- Agents return-home arrow and sidebar toggle share the top navigation row. The return arrow uses the existing orange brand color with an icon-only circular surface; duplicate sidebar return row removed. Expanded, collapsed and preview states remain usable on macOS/Windows; Linux retains its native frame with an application navigation row.
+- README synchronized. No cloud service, authentication, billing or real model submission changed.
+- Temporary app replacement prepared under `.trial-runtime/agent-entry-nav-20261012-a13e56c9`; final runtime/UI observation pending.
+
+## Verification
+
+- Entry agent: 47 tests passed across new 7-entry checks and existing page/module checks; scoped lint passed.
+- Root: 51 focused navigation/titlebar/peek/module checks pass after updating one stale “智能体工作区” title expectation to the previously accepted “我的智能体”; typecheck and scoped lint passed.
+- Production build passed (existing bundle-size/import/Browserslist warnings).
+- Electron fixture E2E passed: return and fold controls have equal y and separate x, one return button, collapse/expand, dirty-leave protection, homepage re-entry after recent chat lands on cards, and re-opening chat does not submit/publish again.
+- Task-scoped project-docs drift check passed. Read-only review passed with no actionable findings; 6 Chrome browser layout fixtures passed (Darwin/Win32/Linux × 375/1024): same-row centers, separate 32px hitboxes, collapse/expand and collapsed return; scoped lint passed. Windows 375 is below native desktop minimum, so native chrome separation accepted only at 1024; navigation reachability checked at both widths. Electron card-list screenshot reviewed: return arrow and fold control occupy one horizontal row, with “我的智能体” in the titlebar.
+- Real old trial observed immediately before replacement through full native AX: saved/applied configuration, conversation input empty, no active running action. No real cloud save/publish/chat action performed.
+
+## Follow-ups
+
+- Native trial replacement and manual login/page observation remain before final completion.
+
+## Promotion Candidates
+
+- Update current-state/Agents navigation documentation during integration: explicit module homepage entry always opens “我的智能体” cards while recent/pending recovery is retained; return/fold share the top row and remain available when collapsed.
+- Linux Agents has an application navigation row beneath the native window frame; other Linux modules preserve their prior titlebar behavior.