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

# 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: Ready for Integration

## 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 updated and opened as `Makelore Agent Entry Trial.app` under `.trial-runtime/agent-entry-nav-20261012-a13e56c9`, using this owned source and retained original trial profile. Implementation commit: `5e99804`.
- Hidden isolated startup probe passed, public health via DIRECT returned 200. Replacement confirmed only the old task-specific shell, started PID 63739 / Host API port 62867, retained profile and foreground, and updated current pointer. No mock data or cloud writes introduced.
- Real native UI observed the new source’s module homepage, and clicking Agents correctly reached the normal login gate. Manual login is pending; real card-list/navigation acceptance is not claimed before authentication. Async manual-login request delivered.

## 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

- User must log in to the updated temporary app before real card-list/navigation observation can continue. Code, fixture behavior/layout and runtime replacement are complete; this manual acceptance step remains explicitly unverified.

## 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.