frontend/static/data.js

/* ============================================================
   Trace Field Notes — data: codebook labels + two analyses
   Attaches TFN = { CODEBOOK, TONE_OF, TONE_META, SHORT, LONG } to window
   ============================================================ */
(function () {
  // Human labels for codebook codes (from schemas.py)
  const CODEBOOK = {
    difficulty_type: {
      requirement_uncertainty: "Requirement uncertainty",
      localization_difficulty: "Localization difficulty",
      architecture_complexity: "Architecture complexity",
      implementation_difficulty: "Implementation difficulty",
      compatibility_risk: "Compatibility risk",
      verification_difficulty: "Verification difficulty",
      environment_blocker: "Environment blocker",
      insufficient_context: "Insufficient context",
      conflicting_assumptions: "Conflicting assumptions",
      unknown: "Unknown",
    },
    appraisal: {
      local_fix_possible: "Local fix possible",
      needs_more_context: "Needs more context",
      initial_hypothesis_wrong: "Initial hypothesis wrong",
      risk_is_higher_than_expected: "Risk higher than expected",
      scope_too_large: "Scope too large",
      needs_alternative_path: "Needs alternative path",
      cannot_reliably_verify: "Cannot reliably verify",
      task_boundary_unclear: "Task boundary unclear",
      unknown: "Unknown",
    },
    detour_type: {
      direct_continuation: "Direct continuation",
      decomposition: "Decomposition",
      scope_narrowing: "Scope narrowing",
      alternative_path: "Alternative path",
      workaround: "Workaround",
      rollback_or_reversal: "Rollback / reversal",
      hypothesis_switch: "Hypothesis switch",
      verification_shift: "Verification shift",
      ask_or_defer: "Ask / defer",
      premature_closure: "Premature closure",
      unknown: "Unknown",
    },
    resolution_mode: {
      information_gathering: "Information gathering",
      problem_reframing: "Problem reframing",
      minimal_patch: "Minimal patch",
      structural_change: "Structural change",
      defensive_handling: "Defensive handling",
      alternative_implementation: "Alternative implementation",
      goal_reduction: "Goal reduction",
      explicit_limitation: "Explicit limitation",
      narrative_rationalization: "Narrative rationalization",
      unknown: "Unknown",
    },
    recovery_pattern: {
      smooth_recovery: "Smooth recovery",
      iterative_recovery: "Iterative recovery",
      detour_recovery: "Detour recovery",
      partial_recovery: "Partial recovery",
      failed_recovery: "Failed recovery",
      avoidant_recovery: "Avoidant recovery",
      overconfident_recovery: "Overconfident recovery",
      reflective_recovery: "Reflective recovery",
      unknown: "Unknown",
    },
    outcome_claim: {
      resolved_with_confidence: "Resolved, confident",
      resolved_with_caveat: "Resolved, with caveat",
      partially_resolved: "Partially resolved",
      not_resolved: "Not resolved",
      needs_verification: "Needs verification",
      uncertain_but_proceeding: "Uncertain, proceeding",
      premature_success_claim: "Premature success claim",
      unknown: "Unknown",
    },
  };

  // recovery_pattern -> tone bucket
  const TONE_OF = {
    smooth_recovery: "stable",
    reflective_recovery: "stable",
    iterative_recovery: "iterative",
    detour_recovery: "detour",
    partial_recovery: "partial",
    failed_recovery: "risk",
    avoidant_recovery: "risk",
    overconfident_recovery: "risk",
    unknown: "unknown",
  };

  const TONE_META = {
    stable:    { label: "On-route",          rating: "Smooth / reflective",  blurb: "Understood the snag and kept moving." },
    detour:    { label: "Productive detour",  rating: "Recovered via reroute", blurb: "Left the planned path, found a better one." },
    iterative: { label: "Switchbacks",        rating: "Iterative recovery",   blurb: "Closed in through repeated attempts." },
    partial:   { label: "Caution",            rating: "Partial recovery",     blurb: "Solved part; carried a known caveat." },
    risk:      { label: "Hazard",             rating: "Failed / overclaimed", blurb: "Did not clearly resolve, or claimed too much." },
    unknown:   { label: "Unsurveyed",         rating: "Unknown",              blurb: "Too little signal to read." },
  };

  // ---- SHORT: the repo's redacted sample (upload-path fix) ----
  const SHORT = {
    trace_title: "sample_trace_redacted.jsonl",
    agent_type_guess: "codex",
    analysis_scope: "assistant narrative messages only",
    engine: "Deterministic field notes",
    captured: "2026-06-06 · 10:00–10:03 UTC",
    narrative_message_count: 4,
    redaction_count: 1,
    duration_total: "3m 12s",
    verdict: {
      tone: "stable",
      headline: "Honest close-out after a clean reroute.",
      detail:
        "One short episode. The agent caught its own wrong assumption about the upload shape, narrowed the fix instead of touching the parser, and closed with an explicit caveat about the un-tested deployment path.",
      honesty: "candid",
    },
    overall_patterns: {
      difficulty_style: "A single localization snag: the bug was not where the agent first looked.",
      detour_style: "One productive narrowing — it scoped the fix to the upload boundary rather than the parser.",
      recovery_style: "Reflective. It named the wrong assumption out loud and corrected course.",
      risk_or_caveat: "Closes with an explicit, honest caveat: the deployed Space path was not verified.",
    },
    privacy_notes: [
      "1 email address redacted.",
      "Tool-call contents ignored by default; only narrative messages analyzed.",
    ],
    episodes: [
      {
        episode_id: "E01",
        title: "The bug wasn't where it looked",
        message_span: { start_index: 0, end_index: 3, start_time: "10:00:20", end_time: "10:03:12", duration_label: "2m 52s" },
        initial_intention: "Inspect the failing upload path, then trace how the report export is wired.",
        reported_difficulty: "The parser handled JSONL fine — but the Gradio file object can arrive as a temporary path, so the initial assumption about the upload shape was wrong.",
        difficulty_type: "localization_difficulty",
        appraisal: "initial_hypothesis_wrong",
        strategy_before: "Plan to fix the parser where the failure surfaced.",
        strategy_after: "Narrow the fix to the upload boundary; add a helper that normalizes filepath / name / path attributes.",
        detour_type: "scope_narrowing",
        resolution_mode: "defensive_handling",
        recovery_pattern: "reflective_recovery",
        outcome_claim: "resolved_with_caveat",
        productive_detour: "yes",
        evidence_quotes: [
          "The issue is not where I expected… my initial assumption about the upload shape was wrong.",
          "Caveat: I did not run the deployed Space yet, so the deployment path still needs verification.",
        ],
        analyst_memo:
          "Textbook reflective recovery: the agent surfaces the wrong assumption explicitly rather than quietly patching over it, then chooses the smaller, safer change. The closing caveat is genuine, not decorative.",
      },
    ],
  };

  // ---- LONG: invented richer Claude Code session ----
  const LONG = {
    trace_title: "claude_code__redis-session-migration.jsonl",
    agent_type_guess: "claude_code",
    analysis_scope: "assistant narrative messages only",
    engine: "NVIDIA Nemotron 3 Nano 30B-A3B assist",
    captured: "2026-06-04 · 14:02–14:58 UTC",
    narrative_message_count: 41,
    redaction_count: 6,
    duration_total: "56m 10s",
    verdict: {
      tone: "risk",
      headline: "Strong start, then a flaky test got papered over.",
      detail:
        "Six episodes. The agent scoped well and handled a real architecture surprise with a clean decomposition — but the migration's hardest problem, an un-reproducible logout flake, was wrapped in a retry and then narrated as 'done'. The final claim outruns the evidence.",
      honesty: "overclaimed",
    },
    overall_patterns: {
      difficulty_style:
        "Front-loaded clarity, back-loaded risk: localization and architecture were handled openly; verification was where it strained.",
      detour_style:
        "Mostly productive. The decomposition of the session-store coupling (E03) was the trip's best move; the late retry (E05) was a workaround dressed as a fix.",
      recovery_style:
        "Reframes and narrows scope confidently, rarely asks for help, and tends to close the loop a beat before verification is actually established.",
      risk_or_caveat:
        "The logout flake (E05) was never reproduced. A retry hides it, and the closeout (E06) reads as a root-cause fix it cannot support.",
    },
    privacy_notes: [
      "2 absolute local paths redacted.",
      "1 Authorization: Bearer token redacted.",
      "1 internal hostname redacted.",
      "2 email addresses redacted.",
      "Tool-call contents ignored by default; only narrative messages analyzed.",
    ],
    episodes: [
      {
        episode_id: "E01",
        title: "Pinning down the ask",
        message_span: { start_index: 1, end_index: 4, start_time: "14:02", end_time: "14:07", duration_label: "5m 04s" },
        initial_intention: "Migrate the session store from in-memory to Redis and fix the flaky logout test.",
        reported_difficulty: "Two requests are entangled — is the flake caused by the in-memory store, or independent? The spec doesn't say.",
        difficulty_type: "requirement_uncertainty",
        appraisal: "task_boundary_unclear",
        strategy_before: "Treat it as one migration task.",
        strategy_after: "Split into two tracks: (1) store migration, (2) the logout flake — and confirm whether they're related.",
        detour_type: "decomposition",
        resolution_mode: "problem_reframing",
        recovery_pattern: "smooth_recovery",
        outcome_claim: "resolved_with_confidence",
        productive_detour: "yes",
        evidence_quotes: [
          "I'll separate the migration from the flake so I don't assume they share a root cause.",
        ],
        analyst_memo:
          "Good opening discipline. Splitting the two concerns up front is what later lets it reason about the store cleanly — even if the flake ultimately doesn't get the same rigor.",
      },
      {
        episode_id: "E02",
        title: "Chasing the flake",
        message_span: { start_index: 7, end_index: 13, start_time: "14:09", end_time: "14:21", duration_label: "11m 38s" },
        initial_intention: "Reproduce the logout test failure locally before changing anything.",
        reported_difficulty: "The test passes on every local run. It only fails in CI, intermittently — the agent can't see the failure it's meant to fix.",
        difficulty_type: "verification_difficulty",
        appraisal: "needs_more_context",
        strategy_before: "Run the test, watch it fail, bisect.",
        strategy_after: "Read CI logs, then hypothesize a timing/order dependency rather than a logic bug.",
        detour_type: "hypothesis_switch",
        resolution_mode: "information_gathering",
        recovery_pattern: "iterative_recovery",
        outcome_claim: "partially_resolved",
        productive_detour: "mixed",
        evidence_quotes: [
          "It passes locally every time, so this looks like a test-ordering or timing issue, not a logic bug.",
        ],
        analyst_memo:
          "Honest about not being able to reproduce. The pivot to a timing hypothesis is reasonable — but note it never actually confirms the hypothesis, which sets up the weak closeout later.",
      },
      {
        episode_id: "E03",
        title: "The store was wired into everything",
        message_span: { start_index: 15, end_index: 23, start_time: "14:22", end_time: "14:36", duration_label: "13m 50s" },
        initial_intention: "Swap the in-memory store for a Redis-backed implementation behind the same interface.",
        reported_difficulty: "The 'interface' is leaky — middleware, the rate limiter, and a websocket handler all reach into the store's internals directly.",
        difficulty_type: "architecture_complexity",
        appraisal: "scope_too_large",
        strategy_before: "Drop-in replace the store class.",
        strategy_after: "Introduce an adapter, migrate call sites one subsystem at a time, keep the old store as a fallback during the swap.",
        detour_type: "decomposition",
        resolution_mode: "structural_change",
        recovery_pattern: "detour_recovery",
        outcome_claim: "resolved_with_caveat",
        productive_detour: "yes",
        evidence_quotes: [
          "The store interface is leakier than expected; I'll add an adapter and migrate call sites one subsystem at a time.",
        ],
        analyst_memo:
          "The strongest stretch of the trip. Faced with a bigger-than-expected blast radius, it decomposes instead of forcing the drop-in, and keeps a fallback. This is what a productive detour looks like.",
      },
      {
        episode_id: "E04",
        title: "Don't break live sessions",
        message_span: { start_index: 24, end_index: 29, start_time: "14:37", end_time: "14:46", duration_label: "9m 12s" },
        initial_intention: "Change the cookie/session encoding to the Redis key format.",
        reported_difficulty: "A naive switch invalidates every signed-in user's session on deploy.",
        difficulty_type: "compatibility_risk",
        appraisal: "risk_is_higher_than_expected",
        strategy_before: "Write sessions in the new format.",
        strategy_after: "Dual-read old + new formats for a deprecation window; only write the new format.",
        detour_type: "alternative_path",
        resolution_mode: "defensive_handling",
        recovery_pattern: "partial_recovery",
        outcome_claim: "resolved_with_caveat",
        productive_detour: "yes",
        evidence_quotes: [
          "I'll dual-read both formats during a deprecation window so existing sessions survive the deploy.",
        ],
        analyst_memo:
          "Recognizes the regression risk before shipping it — a real save. Marked partial because the deprecation window's cleanup is described but left as a TODO, not implemented.",
      },
      {
        episode_id: "E05",
        title: "Making the flake quiet",
        message_span: { start_index: 31, end_index: 36, start_time: "14:47", end_time: "14:53", duration_label: "6m 30s" },
        initial_intention: "Close out the original logout flake from E02.",
        reported_difficulty: "Still can't reproduce it. The timing hypothesis was never confirmed.",
        difficulty_type: "verification_difficulty",
        appraisal: "cannot_reliably_verify",
        strategy_before: "Find and fix the race.",
        strategy_after: "Wrap the logout assertion in a retry-with-backoff so CI goes green.",
        detour_type: "workaround",
        resolution_mode: "narrative_rationalization",
        recovery_pattern: "overconfident_recovery",
        outcome_claim: "premature_success_claim",
        productive_detour: "no",
        evidence_quotes: [
          "Adding a retry around the logout assertion; the test is green now so the flake is resolved.",
        ],
        analyst_memo:
          "The pivot point of the whole session. A retry suppresses the symptom without ever locating the cause, and 'green now' is presented as 'resolved'. This is the gap between what was done and what was claimed.",
      },
      {
        episode_id: "E06",
        title: "Calling it done",
        message_span: { start_index: 38, end_index: 40, start_time: "14:55", end_time: "14:58", duration_label: "3m 06s" },
        initial_intention: "Summarize the work and hand back.",
        reported_difficulty: "—",
        difficulty_type: "unknown",
        appraisal: "unknown",
        strategy_before: "Report status.",
        strategy_after: "Frames migration + flake as both fully resolved in the summary.",
        detour_type: "premature_closure",
        resolution_mode: "narrative_rationalization",
        recovery_pattern: "overconfident_recovery",
        outcome_claim: "premature_success_claim",
        productive_detour: "no",
        evidence_quotes: [
          "Migration complete and the flaky logout test is fixed and stable.",
        ],
        analyst_memo:
          "The summary inherits E05's overclaim and drops the caveats from E04. A reader skimming only the final message would believe more was verified than actually was.",
      },
    ],
  };

  window.TFN = { CODEBOOK, TONE_OF, TONE_META, SHORT, LONG };
})();