Function deduped_cursor_hint

src/hooks/cursor.rs:402–440

Suppresses hints that were already emitted for this session. The `(session_id, category)` pairs are persisted in `.tracedecay/tool_hints_seen.json` so each hint category surfaces at most once per Cursor session across short-lived hook processes. Hints are also suppressed entirely when the workspace has no tracedecay index (suggesting tracedecay tools there would be misleading). When no session id

(event_json: &str, hint_id: &str, hint: ToolHint)

/// the hint is emitted as-is — dedupe is impossible but the hint is still
/// useful (fail-open).
fn deduped_cursor_hint(event_json: &str, hint_id: &str, hint: ToolHint) -> Option<ToolHint> {
    let Ok(parsed) = serde_json::from_str::<Value>(event_json) else {
        // The candidate was already recorded against `hint_id`; close its outcome
        // with a terminal event instead of dropping it silently.
        record_hint_analytics(
            None,
            "dropped_no_root",
            HintAgent::Cursor,
            None,
            hint_id,
            &hint,
        );
        return None;
    };
    let session_id = event_session_id(&parsed);
    let Some(root) = cursor_project_root_candidate_from_parsed_event(&parsed) else {
        record_hint_analytics(
            None,
            "dropped_no_root",
            HintAgent::Cursor,
            session_id.as_deref(),
            hint_id,
            &hint,
        );
        return None;
    };
    if !crate::tracedecay::TraceDecay::is_initialized(&root) {
        record_hint_analytics(
            Some(&root),
            "suppressed_uninitialized",
            HintAgent::Cursor,
            session_id.as_deref(),
            hint_id,
            &hint,
        );
        return None;
    }
    deduped_project_hint_with_id(Some(root), HintAgent::Cursor, session_id, hint_id, hint)
}

pub fn cursor_project_root_from_event(event_json: &str) -> Option<PathBuf> {
    let parsed: Value = serde_json::from_str(event_json).ok()?;