docs: finalize AI logging format system
- align ai-worklog and ai-prompts with the current logging framework - require timestamped structured log entries - finalize logging rules in instructions-agent.md
This commit is contained in:
@@ -1,27 +1,40 @@
|
||||
# AI Worklog
|
||||
|
||||
This file records important AI-assisted development actions.
|
||||
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)
|
||||
The log is designed for long‑term traceability of AI‑driven development.
|
||||
|
||||
Entries must be concise and chronological.
|
||||
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
|
||||
Task: build
|
||||
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`
|
||||
- src/app/ui.py
|
||||
- tests/test_ui.py
|
||||
|
||||
Key Decisions:
|
||||
- Keep `b` and `f` unchanged.
|
||||
@@ -34,131 +47,208 @@ Validation:
|
||||
- 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.
|
||||
- History mode now shows only the history list and allows navigation and selection of past directories.
|
||||
|
||||
Open Issues:
|
||||
- None.
|
||||
- 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.
|
||||
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:
|
||||
- `src/app/ui.py`
|
||||
- `tests/test_ui.py`
|
||||
- `docs/ai-worklog.md`
|
||||
- `docs/ai-prompts.md`
|
||||
- instructions-agent.md
|
||||
- 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.
|
||||
- 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:
|
||||
- The repository now defines mandatory AI logging in `instructions-agent.md` and includes dedicated log files for AI work history and prompt summaries.
|
||||
- Repository now enforces AI logging via instructions-agent.md.
|
||||
|
||||
Open Issues:
|
||||
- None.
|
||||
- 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.
|
||||
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`
|
||||
- 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.
|
||||
- Define AI BUILD ENTRY and AI PLAN ENTRY blocks.
|
||||
- Standardize structure for long‑term repository traceability.
|
||||
|
||||
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.
|
||||
- Repository now uses a standardized AI logging format.
|
||||
|
||||
Open Issues:
|
||||
- None.
|
||||
- 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
|
||||
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`
|
||||
- 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.
|
||||
- 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-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.
|
||||
- Tree navigation semantics improved with clearer expand, enter, and cancel behavior.
|
||||
|
||||
Open Issues:
|
||||
- None.
|
||||
- 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
|
||||
|
||||
Reference in New Issue
Block a user