doc:updated tasks

TASKS.md

@@ -130,59 +130,91 @@ Acceptance Criteria:
 - Prompt limits scope to one small implementation step
 - Add/update tests
 
-## TASK-012 — Agent telemetry foundation
+## TASK-012 — Telemetry foundation
 
 Status: Todo
 
 Goal:
-Create a minimal telemetry writer for future agent activity tracking.
+Create a minimal telemetry system that can record structured agent activity for future guardrail and analysis features.
 
 Implementation Gap:
-There is currently no persistent session log for recording agent activity. Guardrails infer behaviour from markdown and RUN_LOG.md instead of structured telemetry.
+
+The project currently infers agent behaviour from documentation, task files, and run logs.
+
+There is no structured event log showing what actions an agent actually performed during a session.
 
 Acceptance Criteria:
 
-- Add a telemetry module
+- Create a telemetry module
-- Create `.rdb/session-log.jsonl` when recording an event
+- Create `.rdb/session-log.jsonl` automatically when recording an event
-- Record JSONL events with:
+- Support recording events in JSONL format
+- Each event contains:
   - timestamp
   - event_type
   - target
   - details
-- Add tests for writing and appending telemetry events
+- Provide a simple public function for writing telemetry events
-- Do not integrate telemetry into every CLI command yet
+- Add/update tests
 
-## TASK-013 — Log CLI command execution
+Example Event:
+
+```json
+{
+  "timestamp": "2026-06-02T12:00:00Z",
+  "event_type": "command",
+  "target": "rdb prompt",
+  "details": {}
+}
+```
+
+Constraints:
+
+- Do not integrate telemetry into existing commands yet
+- Do not modify guardrails yet
+- Do not implement dashboards or reporting
+- Build the smallest useful telemetry foundation only
+
+Definition of Done:
+
+- Telemetry writer exists
+- JSONL file is created correctly
+- Events append correctly
+- Tests pass
+- Documentation updated if required
+
+## TASK-013 — Record CLI command execution
 
 Status: Todo
 
 Goal:
-Record rdb CLI command execution into telemetry.
+Record rdb CLI command execution using the telemetry system.
 
 Implementation Gap:
-Telemetry writer exists, but CLI commands do not yet record command execution events.
+
+Telemetry storage exists but no command activity is recorded.
 
 Acceptance Criteria:
 
 - Record command execution events
 - Include command name
-- Include success/failure where practical
+- Include timestamp
 - Add/update tests
 
-## TASK-014 — Use telemetry in guardrails
+## TASK-014 — Integrate telemetry with guardrails
 
 Status: Todo
 
 Goal:
-Make `rdb guardrails` use structured telemetry when available.
+Use structured telemetry data in guardrail analysis.
 
 Implementation Gap:
-Guardrails currently rely on markdown and file mtimes rather than `.rdb/session-log.jsonl`.
+
+Guardrails currently rely on heuristics and markdown files rather than actual activity records.
 
 Acceptance Criteria:
 
-- Read telemetry events when present
+- Read telemetry events
-- Detect repeated reads from telemetry
+- Detect repeated commands
-- Detect repeated commands from telemetry
+- Detect repeated reads when available
-- Fall back gracefully if telemetry is missing
+- Fall back gracefully when telemetry is absent
 - Add/update tests