Saky
6849631cc1
- align ai-worklog and ai-prompts with the current logging framework - require timestamped structured log entries - finalize logging rules in instructions-agent.md
255 lines
5.1 KiB
Markdown
255 lines
5.1 KiB
Markdown
# AI Worklog
|
||
|
||
This file records important AI‑assisted development actions.
|
||
|
||
The log is designed for long‑term traceability of AI‑driven development.
|
||
|
||
Each entry must include:
|
||
- Date (YYYY-MM-DD HH:MM)
|
||
- Task ID
|
||
- Agent
|
||
- Task type (plan/build)
|
||
- Objective
|
||
- Scope
|
||
- Files Modified / Files Inspected
|
||
- Key Decisions or Proposed Changes
|
||
- Validation
|
||
- Result
|
||
- Open Issues
|
||
|
||
Entries must remain chronological.
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 18:10
|
||
Task ID: BUILD-20260315-001
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Replace the temporary history debug overlay with a dedicated history mode in the terminal UI.
|
||
|
||
Scope:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
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 and allows navigation and selection of past directories.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 19:30
|
||
Task ID: BUILD-20260315-002
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Introduce mandatory AI logging rules and repository logging workflow.
|
||
|
||
Scope:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Files Modified:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Require AI agents to log plan and build tasks.
|
||
- Separate logs for work results and prompts.
|
||
- Keep entries concise and user‑focused.
|
||
|
||
Validation:
|
||
- not run
|
||
|
||
Result:
|
||
- Repository now enforces AI logging via instructions-agent.md.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 20:05
|
||
Task ID: BUILD-20260315-003
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Introduce the standard AI log entry format and improve logging consistency.
|
||
|
||
Scope:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Files Modified:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Define AI BUILD ENTRY and AI PLAN ENTRY blocks.
|
||
- Standardize structure for long‑term repository traceability.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- Repository now uses a standardized AI logging format.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 21:40
|
||
Task ID: BUILD-20260315-004
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Improve keyboard navigation behavior in the terminal UI for tree mode.
|
||
|
||
Scope:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
Files Modified:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
Key Decisions:
|
||
- Right expands collapsed directories and enters expanded directories.
|
||
- Left collapses expanded directories or navigates to the parent directory.
|
||
- Enter confirms the selected path.
|
||
- ESC cancels and returns to the original directory.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- Tree navigation semantics improved with clearer expand, enter, and cancel behavior.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-15 22:25
|
||
Task ID: BUILD-20260315-005
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Implement vertical scrolling so the selected entry always remains visible.
|
||
|
||
Scope:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
Files Modified:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
|
||
Key Decisions:
|
||
- Introduce scroll offsets in the UI state.
|
||
- Clamp offsets to keep the selected row visible.
|
||
- Apply the same mechanism to history mode.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- Tree and history views now scroll when navigating beyond the visible screen area.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-16 00:27
|
||
Task ID: BUILD-20260316-001
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Consolidate terminal UI navigation improvements and document updated behavior.
|
||
|
||
Scope:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Files Modified:
|
||
- src/app/ui.py
|
||
- tests/test_ui.py
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Maintain dedicated history mode.
|
||
- Refine tree-mode keyboard behavior.
|
||
- Keep UI logic isolated from navigator logic.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- Terminal UI now includes history mode, improved navigation semantics, and reliable vertical scrolling.
|
||
|
||
Open Issues:
|
||
- None
|
||
|
||
---
|
||
|
||
### AI BUILD ENTRY
|
||
Date: 2026-03-16 01:26
|
||
Task ID: BUILD-20260316-002
|
||
Agent: OpenCode
|
||
Task: build
|
||
Objective: Finalize the AI logging format system and align repository log files with the structured logging framework.
|
||
|
||
Scope:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Files Modified:
|
||
- instructions-agent.md
|
||
- docs/ai-worklog.md
|
||
- docs/ai-prompts.md
|
||
|
||
Key Decisions:
|
||
- Require timestamped log entries with date and time, Task ID, Agent, and Scope fields.
|
||
- Keep the worklog and prompt log aligned with the current structured logging framework.
|
||
- Normalize prompt logging into a single consistent `BUILD PROMPT ENTRY` format.
|
||
|
||
Validation:
|
||
- make fix (passed)
|
||
- make quality (passed)
|
||
|
||
Result:
|
||
- The AI logging system now uses consistent structured entries across repository instructions, worklog history, and prompt history.
|
||
|
||
Open Issues:
|
||
- None
|