cd-browser/docs/ai-worklog.md

AI Worklog

This file records important AI-assisted development actions.

Each entry should include:

• date
• task type (plan/build)
• objective
• files inspected or modified
• key decisions
• validation commands executed
• result
• open issues (if any)

Entries must be concise and chronological.

AI BUILD ENTRY

Date: 2026-03-15
Task: build
Objective: Replace the temporary history debug overlay with a dedicated history mode in the terminal UI.

Files Modified:

• src/app/ui.py
• tests/test_ui.py

Key Decisions:

• Keep b and f unchanged.
• Add separate history-mode selection state inside the UI.
• Hide the tree while history mode is active.
• Use Enter to select a history entry and return to the tree view.

Validation:

• make fix
• make quality

Result:

• History mode now shows only the history list, supports Up/Down selection, allows Enter to jump to a prior directory, and exits cleanly back to normal navigation.

Open Issues:

• None.

AI BUILD ENTRY

Date: 2026-03-16 00:27
Task: build
Objective: Consolidate recent terminal UI navigation improvements and document the updated interaction behavior.

Files Modified:

• src/app/ui.py
• tests/test_ui.py
• docs/ai-worklog.md
• docs/ai-prompts.md

Key Decisions:

• Keep dedicated history mode while refining tree-mode keyboard behavior for Right, Left, Enter, and ESC.
• Add scroll continuity for both tree and history views so the selected row remains visible on long lists.
• Cover the UI-focused behavior with helper-level tests instead of changing navigator or filesystem logic.

Validation:

• make fix (passed)
• make quality (passed)

Result:

• The terminal UI now combines dedicated history mode, clearer confirmation and cancellation behavior, improved tree navigation semantics, and vertical scrolling that keeps the current selection visible in both tree and history views.

Open Issues:

• None.

AI BUILD ENTRY

Date: 2026-03-15
Task: build
Objective: Introduce mandatory AI logging rules and document the repository logging workflow.

Files Modified:

• instructions-agent.md
• docs/ai-worklog.md
• docs/ai-prompts.md

Key Decisions:

• Require AI agents to log significant plan and build tasks.
• Preserve separate logs for work performed and prompts received.
• Keep entries concise and user-facing.

Validation:

• not run

Result:

• The repository now defines mandatory AI logging in instructions-agent.md and includes dedicated log files for AI work history and prompt summaries.

Open Issues:

• None.

AI BUILD ENTRY

Date: 2026-03-15
Task: build
Objective: Record the introduction of the standard AI log entry format and improve AI logging consistency.

Files Modified:

• instructions-agent.md
• docs/ai-worklog.md
• docs/ai-prompts.md

Key Decisions:

• Add a dedicated "Standard AI Log Entry Format" section to define AI BUILD ENTRY and AI PLAN ENTRY blocks.
• Use the new standardized format for this worklog update to establish the pattern in the repository logs.

Validation:

• make fix (passed)
• make quality (passed)

Result:

• The repository now documents a standard AI log entry format and uses it to improve consistency of AI-assisted development logs.

Open Issues:

• None.

AI BUILD ENTRY

Date: 2026-03-15
Task: build
Objective: Improve vertical scrolling in the terminal UI so the selected row remains visible in tree mode and history mode.

Files Modified:

• src/app/ui.py
• tests/test_ui.py
• docs/ai-worklog.md
• docs/ai-prompts.md

Key Decisions:

• Add separate scroll offsets for tree mode and history mode inside the UI state.
• Introduce a small helper to clamp scroll offsets so the selected row always stays within the visible window.
• Keep all existing navigation semantics unchanged while limiting the change to UI rendering behavior.

Validation:

• make fix (passed)
• make quality (passed)

Result:

• The terminal UI now scrolls vertically in both tree mode and history mode to keep the current selection visible when the list is taller than the screen.

Open Issues:

• None.

AI BUILD ENTRY

Date: 2026-03-15
Task: build
Objective: Improve keyboard navigation behavior in the terminal UI for tree mode.

Files Modified:

• src/app/ui.py
• tests/test_ui.py

Key Decisions:

• Make Right expand collapsed directories and enter already expanded directories.
• Make Left collapse expanded directories and otherwise navigate to the parent directory.
• Make Enter confirm the selected path as the final destination and make ESC return the original starting directory.

Validation:

• make fix (passed)
• make quality (passed)

Result:

• Tree-mode keyboard navigation now supports expand-or-enter on Right, collapse-or-parent on Left, explicit selection confirmation on Enter, and cancel-to-start behavior on ESC.

Open Issues:

• None.