diff --git a/apps/backend/internal/task/repository/sqlite/task_status_summary.go b/apps/backend/internal/task/repository/sqlite/task_status_summary.go index 5a0dfe0755..4080cc56a8 100644 --- a/apps/backend/internal/task/repository/sqlite/task_status_summary.go +++ b/apps/backend/internal/task/repository/sqlite/task_status_summary.go @@ -79,6 +79,7 @@ func (r *Repository) LoadTaskLastActivity(ctx context.Context, taskIDs []string) for _, chunk := range chunkIDs(taskIDs, sqliteMaxHostParams/6) { placeholders, ids := buildInPlaceholders(chunk) + lifecycleOnlyPredicate := turnLifecycleOnlyPredicate(r.ro.DriverName(), "task_session_turns") query := ` WITH activity AS ( SELECT id AS task_id, created_at AS activity_at @@ -103,11 +104,13 @@ func (r *Repository) LoadTaskLastActivity(ctx context.Context, taskIDs []string) FROM task_session_turns WHERE task_id IN (` + placeholders + `) AND started_at IS NOT NULL + AND NOT (` + lifecycleOnlyPredicate + `) UNION ALL SELECT task_id, completed_at AS activity_at FROM task_session_turns WHERE task_id IN (` + placeholders + `) AND completed_at IS NOT NULL + AND NOT (` + lifecycleOnlyPredicate + `) ) SELECT task_id, MAX(activity_at) AS activity_at FROM activity diff --git a/apps/backend/internal/task/repository/sqlite/task_status_summary_postgres_test.go b/apps/backend/internal/task/repository/sqlite/task_status_summary_postgres_test.go index cbd62205c2..ad91f5d755 100644 --- a/apps/backend/internal/task/repository/sqlite/task_status_summary_postgres_test.go +++ b/apps/backend/internal/task/repository/sqlite/task_status_summary_postgres_test.go @@ -119,6 +119,17 @@ func TestPostgresTaskLastActivityBatch(t *testing.T) { }, 10); err != nil { t.Fatalf("insert postgres queued agent prompt: %v", err) } + lifecycleCompletedAt := base.Add(8 * time.Hour) + if err := repo.CreateTurn(ctx, &models.Turn{ + ID: "turn-activity-postgres-lifecycle", + TaskSessionID: "session-activity-postgres", + TaskID: "task-activity-postgres", + StartedAt: base.Add(7 * time.Hour), + CompletedAt: &lifecycleCompletedAt, + Metadata: map[string]interface{}{models.TurnMetaKeyLifecycleOnly: true}, + }); err != nil { + t.Fatalf("create postgres lifecycle turn: %v", err) + } got, err := repo.LoadTaskLastActivity(ctx, []string{"task-activity-postgres"}) if err != nil { diff --git a/apps/backend/internal/task/repository/sqlite/task_status_summary_test.go b/apps/backend/internal/task/repository/sqlite/task_status_summary_test.go index ab53ecaceb..343079ca04 100644 --- a/apps/backend/internal/task/repository/sqlite/task_status_summary_test.go +++ b/apps/backend/internal/task/repository/sqlite/task_status_summary_test.go @@ -245,6 +245,17 @@ func TestTaskLastActivityBatch(t *testing.T) { }); err != nil { t.Fatalf("create agent message: %v", err) } + lifecycleCompletedAt := base.Add(14 * time.Hour) + if err := repo.CreateTurn(ctx, &models.Turn{ + ID: "turn-activity-lifecycle", + TaskSessionID: "session-activity-turn", + TaskID: "task-activity-turn", + StartedAt: base.Add(13 * time.Hour), + CompletedAt: &lifecycleCompletedAt, + Metadata: map[string]interface{}{models.TurnMetaKeyLifecycleOnly: true}, + }); err != nil { + t.Fatalf("create lifecycle turn: %v", err) + } if err := repo.CreateTurn(ctx, &models.Turn{ ID: "turn-activity-active", TaskSessionID: "session-activity-active", diff --git a/apps/backend/internal/task/statussummary/projector_events.go b/apps/backend/internal/task/statussummary/projector_events.go index 36b9604bcf..10eb54a54d 100644 --- a/apps/backend/internal/task/statussummary/projector_events.go +++ b/apps/backend/internal/task/statussummary/projector_events.go @@ -7,6 +7,7 @@ import ( "time" "github.com/kandev/kandev/internal/events" + "github.com/kandev/kandev/internal/task/models" ) func (p *Projector) applySourceEventLocked(state *projectionState, eventType string, data map[string]interface{}) bool { @@ -85,8 +86,14 @@ func applyTaskActivityEventLocked(state *projectionState, eventType string, data } candidate = timeValue(data["queued_at"]) case events.TurnStarted: + if isLifecycleOnlyTurn(data) { + return false + } candidate = timeValue(data["started_at"]) case events.TurnCompleted: + if isLifecycleOnlyTurn(data) { + return false + } candidate = timeValue(data["completed_at"]) default: return false @@ -94,6 +101,11 @@ func applyTaskActivityEventLocked(state *projectionState, eventType string, data return advanceTaskActivity(state, candidate) } +func isLifecycleOnlyTurn(data map[string]interface{}) bool { + metadata, _ := data["metadata"].(map[string]interface{}) + return boolValue(metadata[models.TurnMetaKeyLifecycleOnly]) +} + func isUserQueuedPrompt(data map[string]interface{}) bool { queuedBy := stringField(data, "queued_by") return queuedBy != "" && queuedBy != "agent" && queuedBy != "workflow" && queuedBy != "server" diff --git a/apps/backend/internal/task/statussummary/projector_test.go b/apps/backend/internal/task/statussummary/projector_test.go index 017f59ad80..2fee9e338b 100644 --- a/apps/backend/internal/task/statussummary/projector_test.go +++ b/apps/backend/internal/task/statussummary/projector_test.go @@ -15,6 +15,7 @@ import ( "github.com/kandev/kandev/internal/common/logger" "github.com/kandev/kandev/internal/events" "github.com/kandev/kandev/internal/events/bus" + "github.com/kandev/kandev/internal/task/models" ) type projectorTestStore struct { @@ -448,6 +449,48 @@ func TestProjectorLastActivityTracksBoundedSourcesMonotonically(t *testing.T) { assertProjectedLastActivity(t, store.summary(taskID), "2026-08-01T18:10:00Z") } +// @covers AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.10 +func TestProjectorLastActivityIgnoresLifecycleTurns(t *testing.T) { + _, store, eventBus, _, _ := newProjectorTest(t) + const taskID = "task-last-activity-lifecycle" + const sessionID = "session-last-activity-lifecycle" + + publishProjectorEvent(t, eventBus, events.TaskCreated, events.TaskCreated, map[string]interface{}{ + "task_id": taskID, + "workspace_id": "workspace-1", + "created_at": "2026-08-01T18:00:00Z", + "updated_at": "2026-08-01T18:00:00Z", + }) + + publishProjectorEvent(t, eventBus, events.TurnStarted, events.TurnStarted, map[string]interface{}{ + "task_id": taskID, + "session_id": sessionID, + "started_at": "2026-08-01T18:01:00Z", + "metadata": map[string]interface{}{models.TurnMetaKeyLifecycleOnly: true}, + }) + publishProjectorEvent(t, eventBus, events.TurnCompleted, events.TurnCompleted, map[string]interface{}{ + "task_id": taskID, + "session_id": sessionID, + "completed_at": "2026-08-01T18:02:00Z", + "metadata": map[string]interface{}{models.TurnMetaKeyLifecycleOnly: true}, + }) + assertProjectedLastActivity(t, store.summary(taskID), "2026-08-01T18:00:00Z") + + publishProjectorEvent(t, eventBus, events.TurnStarted, events.TurnStarted, map[string]interface{}{ + "task_id": taskID, + "session_id": sessionID, + "started_at": "2026-08-01T18:03:00Z", + }) + assertProjectedLastActivity(t, store.summary(taskID), "2026-08-01T18:03:00Z") + + publishProjectorEvent(t, eventBus, events.TurnCompleted, events.TurnCompleted, map[string]interface{}{ + "task_id": taskID, + "session_id": sessionID, + "completed_at": "2026-08-01T18:04:00Z", + }) + assertProjectedLastActivity(t, store.summary(taskID), "2026-08-01T18:04:00Z") +} + func TestProjectorLastActivityRehydratesFromDurableLoader(t *testing.T) { const taskID = "task-last-activity-rehydrate" want := time.Date(2026, 8, 1, 18, 11, 0, 0, time.UTC) diff --git a/docs/decisions/2026-08-17-separate-task-activity-from-summary-freshness.md b/docs/decisions/2026-08-17-separate-task-activity-from-summary-freshness.md index 30a47293ea..43b1a8afb7 100644 --- a/docs/decisions/2026-08-17-separate-task-activity-from-summary-freshness.md +++ b/docs/decisions/2026-08-17-separate-task-activity-from-summary-freshness.md @@ -1,6 +1,6 @@ # ADR-2026-08-17-separate-task-activity-from-summary-freshness: Separate Task Activity From Summary Freshness -**Status:** accepted +**Status:** accepted (amended 2026-08-29) **Date:** 2026-08-17 **Area:** backend, frontend, protocol @@ -24,7 +24,10 @@ rebuildable summary. - task creation or a persisted task mutation - a user-authored prompt, including a prompt that enters the queue -- an agent turn start or completion +- a conversational agent turn start or completion + +A turn with `metadata.lifecycle_only=true` is not conversational. The +synthetic turn named `agent_boot` on resume does not advance task activity. The timestamp does not advance for task focus, session subscription, Git or pull-request polling, queue bookkeeping, status-summary repair, or session @@ -47,9 +50,10 @@ Idle tasks stay stable when background provider status changes. Desktop and mobile saved views can sort by meaningful work without opening task sessions. The backend needs a batched activity query and more bounded projector inputs. -Turn milestones prevent per-chunk agent output from producing task-list update -traffic. A running turn becomes recent when it starts and advances again when -it completes. +Both paths must exclude lifecycle-only turns. Conversational-turn milestones +prevent per-chunk agent output from producing task-list update traffic. A +running conversational turn becomes recent when it starts and advances again +when it completes. Older summaries need a one-time semantic repair. During partial rollout, the frontend falls back to the task update or creation time when @@ -65,3 +69,5 @@ frontend falls back to the task update or creation time when history is not loaded and task switchers must not subscribe to it. - **Write every activity to the task row.** Rejected because message and turn domains gain extra task writes and mix activity with task edits. +- **Count every persisted turn.** Rejected because lifecycle turns record + runtime maintenance, not user or agent work. diff --git a/docs/decisions/INDEX.md b/docs/decisions/INDEX.md index b441b55fe1..6cc6b997b6 100644 --- a/docs/decisions/INDEX.md +++ b/docs/decisions/INDEX.md @@ -183,7 +183,7 @@ Read individual ADRs for full context. Create new ones via `/record decision` or | 2026-08-15-office-mode-follows-active-workspace | [Office Mode Follows the Active Workspace](2026-08-15-office-mode-follows-active-workspace.md) | accepted | frontend, backend | 2026-08-15 | | 2026-08-16-session-mcp-tool-catalog | [Keep MCP Tool Catalogs Session Owned](2026-08-16-session-mcp-tool-catalog.md) | superseded by 2026-08-18-session-mcp-tool-definition-details | backend, agentctl, frontend, protocol, security | 2026-08-16 | | 2026-08-18-session-mcp-tool-definition-details | [Bound MCP Tool Definition Details to Current Sessions](2026-08-18-session-mcp-tool-definition-details.md) | accepted | backend, agentctl, frontend, protocol, security | 2026-08-18 | -| 2026-08-17-separate-task-activity-from-summary-freshness | [Separate Task Activity From Summary Freshness](2026-08-17-separate-task-activity-from-summary-freshness.md) | accepted | backend, frontend, protocol | 2026-08-17 | +| 2026-08-17-separate-task-activity-from-summary-freshness | [Separate Task Activity From Summary Freshness](2026-08-17-separate-task-activity-from-summary-freshness.md) | accepted (amended 2026-08-29) | backend, frontend, protocol | 2026-08-17 | | 2026-08-17-release-pr-ruleset-bypass | [Give Stable Release PRs an Administrator Token Bypass](2026-08-17-release-pr-ruleset-bypass.md) | accepted | infra, workflow, security | 2026-08-17 | | 2026-08-18-never-started-agent-stall-terminal | [Treat Never-Started Agent Stalls as Terminal](2026-08-18-never-started-agent-stall-terminal.md) | accepted | backend, frontend, protocol | 2026-08-18 | | 2026-08-18-plugin-task-row-metadata | [Keep Task Row Plugin Metadata Generic](2026-08-18-plugin-task-row-metadata.md) | accepted | frontend | 2026-08-18 | diff --git a/docs/plans/passive-resume-last-activity/plan.md b/docs/plans/passive-resume-last-activity/plan.md new file mode 100644 index 0000000000..181beeb31d --- /dev/null +++ b/docs/plans/passive-resume-last-activity/plan.md @@ -0,0 +1,92 @@ +--- +created: 2026-08-29 +status: done +requirements: + - REQ-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001 +system_design: + - ../../specs/platform/system-design/bounded-task-status-delivery.md +legacy_specs: [] +--- + +# Implementation Plan: Preserve Last Activity During Passive Resume + +## Overview + +Exclude synthetic lifecycle turns from task activity. Apply the same rule to +live projection and restart reconstruction so both paths stay equivalent. + +## Scope + +### In scope + +- Preserve `last_activity_at` when task opening resumes an idle agent. +- Exclude turns marked `lifecycle_only` from live activity projection. +- Exclude the same turns from SQLite and PostgreSQL activity reconstruction. +- Add focused regression tests for both activity paths. + +### Out of scope + +- Change agent resume, task focus, or session subscription behavior. +- Remove `agent_boot` messages or their synthetic parent turns. +- Change activity for task mutations, user prompts, or conversational turns. +- Change sidebar sorting, labels, or saved-view settings. + +## Technical approach + +### Live projection + +Update `applyTaskActivityEventLocked` in +`apps/backend/internal/task/statussummary/projector_events.go`. Ignore +`turn.started` and `turn.completed` events whose metadata sets +`lifecycle_only`. + +Use the existing marker from `models.TurnMetaKeyLifecycleOnly`. Add projector +tests that compare lifecycle turns with conversational turns. + +### Durable reconstruction + +Update `LoadTaskLastActivity` in +`apps/backend/internal/task/repository/sqlite/task_status_summary.go`. Filter +both turn branches with the existing dialect-aware lifecycle predicate. + +Use `turnLifecycleOnlyPredicate` so SQLite and PostgreSQL use the same marker +semantics. Extend both activity-batch tests with a newer lifecycle turn. The +expected result must remain the latest qualifying activity. + +## Tests + +- `AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.10`: the projector test proves + that lifecycle-turn events do not change `last_activity_at`. +- `AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.10`: the SQLite test proves + that restart reconstruction ignores a newer lifecycle turn. +- The PostgreSQL test uses the same scenario when its test database exists. + +## Work orders + +- [x] [Task 01: Exclude lifecycle turns from activity](task-01-exclude-lifecycle-turns.md) + +## Verification results + +- RED: `cd apps/backend && go test ./internal/task/statussummary -run + TestProjectorLastActivityIgnoresLifecycleTurns -count=1` failed because a + lifecycle-only completion advanced projected activity. +- RED: `cd apps/backend && go test ./internal/task/repository/sqlite -run + 'TestTaskLastActivityBatch|TestPostgresTaskLastActivityBatch' -count=1` + failed because the SQLite batch included the newer lifecycle turn. +- GREEN: `cd apps/backend && go test ./internal/task/statussummary -run + 'LastActivity.*Lifecycle|Lifecycle.*LastActivity'` passed. +- GREEN: `cd apps/backend && go test ./internal/task/repository/sqlite -run + 'TaskLastActivity'` passed. +- GREEN race checks passed for both targeted commands. +- Full affected packages passed: `statussummary` (80 tests) and `sqlite` (814 + tests). +- `gofmt -l` reported no changed Go files, and `git diff --check` passed. + +## Risks + +- Live and reconstructed activity can diverge if only one path applies the + lifecycle marker. +- SQLite and PostgreSQL decode JSON booleans differently. The shared predicate + must retain the existing tolerant marker semantics. +- Conversational turns without the marker must keep their current activity + behavior. diff --git a/docs/plans/passive-resume-last-activity/task-01-exclude-lifecycle-turns.md b/docs/plans/passive-resume-last-activity/task-01-exclude-lifecycle-turns.md new file mode 100644 index 0000000000..220f169468 --- /dev/null +++ b/docs/plans/passive-resume-last-activity/task-01-exclude-lifecycle-turns.md @@ -0,0 +1,97 @@ +--- +id: "01-exclude-lifecycle-turns" +title: "Exclude lifecycle turns from activity" +status: done +wave: 1 +depends_on: [] +plan: "plan.md" +requirements: + - REQ-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001 +acceptance_criteria: + - AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.10 +system_design: + - ../../specs/platform/system-design/bounded-task-status-delivery.md +--- + +# Task 01: Exclude Lifecycle Turns From Activity + +## Summary + +Make lifecycle-only turns invisible to `last_activity_at`. Keep live projection +and restart reconstruction on one marker contract. + +## In scope + +- Add failing live-projector and repository regression tests. +- Ignore lifecycle-only turn events in the task-status projector. +- Filter lifecycle-only rows from the activity reconstruction query. +- Cover SQLite and the environment-gated PostgreSQL path. + +## Out of scope + +- Change lifecycle-turn creation or message history. +- Change agent resume or task-state transitions. +- Change frontend code or saved-view behavior. + +## Acceptance + +- A newer lifecycle-only turn does not change live or rebuilt task activity. +- A newer conversational turn still advances task activity. +- SQLite and PostgreSQL use the existing shared marker predicate. + +## Verification + +```bash +cd apps/backend && go test ./internal/task/statussummary -run 'LastActivity.*Lifecycle|Lifecycle.*LastActivity' +cd apps/backend && go test ./internal/task/repository/sqlite -run 'TaskLastActivity' +``` + +## Files likely touched + +- `apps/backend/internal/task/statussummary/projector_events.go` +- `apps/backend/internal/task/statussummary/projector_test.go` +- `apps/backend/internal/task/repository/sqlite/task_status_summary.go` +- `apps/backend/internal/task/repository/sqlite/task_status_summary_test.go` +- `apps/backend/internal/task/repository/sqlite/task_status_summary_postgres_test.go` + +## Dependencies + +None. + +## Risks + +- A hand-written JSON expression can drift between database dialects. +- An over-broad filter can remove real conversational turns. + +## Parallelism + +`sequential` + +## Inputs + +- `AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.10` +- The activity derivation section in the bounded task-status design. +- `ADR-2026-08-17-separate-task-activity-from-summary-freshness` +- `models.TurnMetaKeyLifecycleOnly` and `turnLifecycleOnlyPredicate`. + +## Results + +- RED: `cd apps/backend && go test ./internal/task/statussummary -run + TestProjectorLastActivityIgnoresLifecycleTurns -count=1` failed because the + lifecycle-only completion timestamp advanced live activity. +- RED: `cd apps/backend && go test ./internal/task/repository/sqlite -run + 'TestTaskLastActivityBatch|TestPostgresTaskLastActivityBatch' -count=1` + failed because the SQLite batch included the newer lifecycle turn. +- GREEN: `cd apps/backend && go test ./internal/task/statussummary -run + 'LastActivity.*Lifecycle|Lifecycle.*LastActivity'` passed. +- GREEN: `cd apps/backend && go test ./internal/task/repository/sqlite -run + 'TaskLastActivity'` passed. +- GREEN race checks passed for both targeted commands. +- Full affected packages passed: `statussummary` (80 tests) and `sqlite` (814 + tests). +- `gofmt -l` reported no changed Go files, and `git diff --check` passed. +- Changed files: `projector_events.go`, `projector_test.go`, + `task_status_summary.go`, `task_status_summary_test.go`, and + `task_status_summary_postgres_test.go`. +- The live projector and durable activity loader now share the existing + `lifecycle_only` marker contract. No known implementation blockers remain. diff --git a/docs/specs/platform/requirements/bounded-task-status-delivery.md b/docs/specs/platform/requirements/bounded-task-status-delivery.md index 4b53436e19..f3e67a0cda 100644 --- a/docs/specs/platform/requirements/bounded-task-status-delivery.md +++ b/docs/specs/platform/requirements/bounded-task-status-delivery.md @@ -2,7 +2,7 @@ status: active system: platform created: 2026-08-01 -updated: 2026-08-27 +updated: 2026-08-29 owners: - kandev --- @@ -33,6 +33,10 @@ Task rows currently obtain compact status indicators by observing large, session flush shall apply all accepted `session.message.updated` replacements in one store transaction while preserving semantic barriers and final transcript content. +- **AC-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001.10:** When task opening resumes + an idle agent after a restart, `status_summary.last_activity_at` shall remain + unchanged. A later task mutation, user prompt, or conversational agent turn + can advance it. ## System design diff --git a/docs/specs/platform/system-design/bounded-task-status-delivery.md b/docs/specs/platform/system-design/bounded-task-status-delivery.md index 13d5a654d6..7fae2e7452 100644 --- a/docs/specs/platform/system-design/bounded-task-status-delivery.md +++ b/docs/specs/platform/system-design/bounded-task-status-delivery.md @@ -4,7 +4,7 @@ system: platform requirements: - REQ-PLATFORM-BOUNDED-TASK-STATUS-DELIVERY-001 created: 2026-08-01 -updated: 2026-08-28 +updated: 2026-08-29 owners: - kandev --- @@ -68,7 +68,7 @@ The initial contract is: | Field | Meaning | Bound | | ---------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------- | | `revision`, `updated_at` | Monotonic task-local version and projection time | Constant | -| `last_activity_at` | Latest durable task, user-prompt, or turn milestone | Constant | +| `last_activity_at` | Latest durable task, user-prompt, or conversational-turn milestone | Constant | | `primary_session` | Primary session ID and lifecycle state | One session | | `foreground_activity`, `active_subagent_count` | Existing task-level busy aggregate | Constant | | `pending_action` | `permission`, `clarification`, or absent | Constant | @@ -145,9 +145,13 @@ remain during migration, but switchers use the summary when present. - Clients ignore a summary delta whose revision is not newer than the stored revision. - `last_activity_at` is separate from projection freshness. Task creation, - persisted task mutations, user-authored prompts, and turn start or completion - advance it by source time. Focus, subscriptions, Git or pull-request polling, - queue bookkeeping, summary repair, and streamed chunks do not advance it. + persisted task mutations, user-authored prompts, and conversational-turn + start or completion advance it by source time. Focus, subscriptions, Git or + pull-request polling, queue bookkeeping, summary repair, and streamed chunks + do not advance it. +- A turn with `metadata.lifecycle_only=true` is not conversational. The live + projector and the durable batch loader exclude these turns. This rule covers + the synthetic `agent_boot` turn that records an agent resume. - Missing and older summaries rebuild `last_activity_at` in one batch from task, user-message, and turn records. Live and rebuilt values use a monotonic maximum, so replay and repair cannot move activity backward. See @@ -306,6 +310,9 @@ intermediate replacement. - **GIVEN** an idle task receives Git or pull-request summary changes, **WHEN** its replacement summary arrives, **THEN** `updated_at` can advance while `last_activity_at` remains unchanged. +- **GIVEN** an idle task after a backend restart, **WHEN** opening the task + resumes its agent and creates only a lifecycle turn, **THEN** + `last_activity_at` remains unchanged. - **GIVEN** a recoverable error is dismissed or followed by a newer agent response, **WHEN** the projector processes that occurrence, **THEN** the independent error indicator clears on both task switchers. diff --git a/docs/specs/ui/requirements/sidebar-last-activity-sort.md b/docs/specs/ui/requirements/sidebar-last-activity-sort.md index 51608c2dd6..9d085ebf20 100644 --- a/docs/specs/ui/requirements/sidebar-last-activity-sort.md +++ b/docs/specs/ui/requirements/sidebar-last-activity-sort.md @@ -2,7 +2,7 @@ status: draft system: ui created: 2026-08-17 -updated: 2026-08-17 +updated: 2026-08-29 owners: - kandev --- @@ -70,8 +70,8 @@ Decision: | Task creation | `tasks.created_at` | | Persisted task mutation | `tasks.updated_at` | | User-authored prompt, including a queued prompt | message `created_at` | -| Agent turn starts | turn `started_at` | -| Agent turn completes | turn `completed_at` | +| Conversational agent turn starts | turn `started_at` | +| Conversational agent turn completes | turn `completed_at` | The following events do not advance activity: @@ -80,6 +80,7 @@ The following events do not advance activity: - queued-prompt count changes and other queue bookkeeping - status-summary rebuilds or transport delivery - session metadata maintenance without a user prompt or agent turn +- synthetic lifecycle turns, including the `agent_boot` turn on resume - streamed agent chunks inside an already-started turn A task-state or workflow-placement change counts because it is a persisted task