release: autter 2.0.2 — blame/stats consistency and Windows ANSI

### Fixed
- Interactive blame notes when lines lack Autter attestations so it no longer looks like it contradicts `autter stats`.
- Gate OSC 8 hyperlinks to capable terminals and enable Windows VT so ConHost does not leak raw escapes.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: sagnik11

CHANGELOG.md

@@ -61,6 +61,13 @@ This changelog is automatically generated by AI when releases are published.
 
 For detailed design rationale and implementation notes, see `docs/superpowers/specs/2026-04-29-telemetry-streams-design.md`.
 
+## [2.0.2] - 2026-09-18
+
+### Fixed
+
+- **Blame vs stats consistency**: when lines have no Autter attestation, interactive `autter blame` now notes that it is showing the git author (same as `git blame`) while `autter stats` counts those lines as untracked — and points at `--mark-unknown`.
+- **ANSI / OSC 8 on Windows**: enable VT processing for color, and only emit OSC 8 hyperlinks when the terminal supports them (e.g. Windows Terminal via `WT_SESSION`), so classic ConHost no longer dumps raw escape sequences.
+
 ## [2.0.1] - 2026-09-17
 
 ### Fixed

Cargo.lock

@@ -8,7 +8,7 @@ resolver = "3"
 
 [package]
 name = "autter"
-version = "2.0.1"
+version = "2.0.2"
 edition = "2024"
 default-run = "autter"
 

Cargo.toml

@@ -33,6 +33,22 @@ pub fn blame_line_missing_data_message() -> String {
     out
 }
 
+/// Short notice when `autter blame` falls back to the git author for lines
+/// without Autter attestations — so it does not contradict `autter stats`,
+/// which reports those same lines as untracked.
+pub fn blame_git_author_fallback_notice(unattested_lines: usize) -> String {
+    if unattested_lines == 1 {
+        "\nNote: 1 line has no Autter attestation, so blame shows the git author \
+(same as `git blame`). `autter stats` counts that line as untracked. Use `--mark-unknown` to label it Unknown.\n"
+            .to_string()
+    } else {
+        format!(
+            "\nNote: {unattested_lines} lines have no Autter attestation, so blame shows the git author \
+(same as `git blame`). `autter stats` counts those lines as untracked. Use `--mark-unknown` to label them Unknown.\n"
+        )
+    }
+}
+
 /// Guidance when `autter show` finds commits but no authorship notes.
 pub fn show_missing_data_message() -> String {
     let mut out = format!("{NO_AUTHORSHIP_DATA_MESSAGE}.\n");
@@ -72,4 +88,16 @@ mod tests {
         assert!(msg.contains("git notes"), "{msg}");
         assert!(msg.contains("autter doctor"), "{msg}");
     }
+
+    #[test]
+    fn blame_fallback_notice_points_at_stats_and_mark_unknown() {
+        let one = blame_git_author_fallback_notice(1);
+        assert!(one.contains("1 line has"), "{one}");
+        assert!(one.contains("autter stats"), "{one}");
+        assert!(one.contains("--mark-unknown"), "{one}");
+
+        let many = blame_git_author_fallback_notice(4);
+        assert!(many.contains("4 lines have"), "{many}");
+        assert!(many.contains("untracked"), "{many}");
+    }
 }

src/authorship/guidance.rs

@@ -195,11 +195,15 @@ pub fn write_stats_to_terminal(stats: &CommitStats, is_interactive: bool) -> Str
     // two anchors (human / AI) otherwise.
     if show_untracked {
         let untracked_percentage = untracked_pct_raw.round() as u32;
-        // When interactive, wrap "untracked" in an OSC 8 hyperlink so it is clickable in
-        // supporting terminals (iTerm2, Warp, etc.). Spaces are constructed manually —
-        // not via format-width padding on the label — so that invisible escape bytes do
-        // not misalign the output.
-        let untracked_label = if is_interactive && colorize {
+        // When interactive *and* the terminal supports OSC 8, wrap "untracked" in a
+        // hyperlink. Color alone is not enough — Windows ConHost with VT enabled still
+        // dumps OSC 8 as literal text. Spaces are constructed manually — not via
+        // format-width padding on the label — so invisible escape bytes do not
+        // misalign the output.
+        let untracked_label = if is_interactive
+            && colorize
+            && crate::commands::arg_parser::use_hyperlinks()
+        {
             "\x1b]8;;https://autter.dev/docs/cli/untracked\x1b\\\x1b[4muntracked\x1b[24m\x1b]8;;\x1b\\"
                 .to_string()
         } else {
@@ -789,18 +793,27 @@ mod tests {
         let all_untracked_output = write_stats_to_terminal(&all_untracked_stats, false);
         assert_debug_snapshot!(all_untracked_output);
 
-        // OSC 8 hyperlink emitted when is_interactive = true
-        // Not a snapshot test — asserts presence of the escape sequence directly.
-        let hyperlink_output = write_stats_to_terminal(&untracked_stats, true);
+        // OSC 8 hyperlink only when the terminal advertises hyperlink support
+        // (see use_hyperlinks). In non-TTY unit tests this stays plain "untracked".
+        let interactive_output = write_stats_to_terminal(&untracked_stats, true);
         assert!(
-            hyperlink_output.contains("\x1b]8;;https://autter.dev/docs/cli/untracked\x1b\\"),
-            "Expected OSC 8 hyperlink in interactive output, got: {:?}",
-            hyperlink_output
-        );
-        assert!(
-            hyperlink_output.contains("untracked"),
+            interactive_output.contains("untracked"),
             "Expected 'untracked' label in interactive output"
         );
+        if crate::commands::arg_parser::use_hyperlinks() {
+            assert!(
+                interactive_output
+                    .contains("\x1b]8;;https://autter.dev/docs/cli/untracked\x1b\\"),
+                "Expected OSC 8 hyperlink when hyperlinks are enabled, got: {:?}",
+                interactive_output
+            );
+        } else {
+            assert!(
+                !interactive_output.contains("\x1b]8;;"),
+                "OSC 8 must not leak when hyperlinks are disabled, got: {:?}",
+                interactive_output
+            );
+        }
     }
 
     #[test]

src/authorship/stats.rs

@@ -165,17 +165,84 @@ fn color_forced_off() -> bool {
     store().read().unwrap().no_color || std::env::var_os("NO_COLOR").is_some()
 }
 
+/// On Windows, enable VT processing (and report whether ANSI works). Without
+/// this, ConHost prints raw `\x1b[…` bytes even when stdout is a TTY. Elsewhere
+/// a TTY is enough.
+fn terminal_supports_ansi() -> bool {
+    #[cfg(windows)]
+    {
+        crossterm::ansi_support::supports_ansi()
+    }
+    #[cfg(not(windows))]
+    {
+        true
+    }
+}
+
 /// Centralized color decision for **stdout**: honor `--no-color`/`--plain`, the
 /// `NO_COLOR` env var, and whether stdout is a TTY. This is the project-wide
 /// `should_colorize()` for human-readable output written via `print!`/`println!`.
 pub fn use_color() -> bool {
-    !color_forced_off() && std::io::stdout().is_terminal()
+    if color_forced_off() || !std::io::stdout().is_terminal() {
+        return false;
+    }
+    terminal_supports_ansi()
 }
 
 /// Same decision as [`use_color`] but keyed on **stderr**'s TTY, for color
 /// emitted via `eprint!`/`eprintln!` (warnings, notices, progress messages).
 pub fn use_color_stderr() -> bool {
-    !color_forced_off() && std::io::stderr().is_terminal()
+    if color_forced_off() || !std::io::stderr().is_terminal() {
+        return false;
+    }
+    terminal_supports_ansi()
+}
+
+/// Whether OSC 8 hyperlinks are safe to emit. Color/VT support is not enough —
+/// classic ConHost with VT enabled still dumps OSC 8 sequences as literal text.
+pub fn use_hyperlinks() -> bool {
+    if !use_color() {
+        return false;
+    }
+    // Explicit opt-out / opt-in (https://gist.github.com/egmontkob/eb114476d1dda0276486)
+    if let Ok(v) = std::env::var("FORCE_HYPERLINK") {
+        return v != "0";
+    }
+    if std::env::var_os("DOMTERM").is_some() {
+        return true;
+    }
+    if let Ok(program) = std::env::var("TERM_PROGRAM") {
+        match program.as_str() {
+            "iTerm.app" | "WezTerm" | "ghostty" | "vscode" | "Hyper" | "kitty" => return true,
+            _ => {}
+        }
+    }
+    if let Ok(term) = std::env::var("TERM") {
+        if term.contains("kitty") || term.contains("vte") || term == "xterm-kitty" {
+            return true;
+        }
+    }
+    // Windows Terminal sets WT_SESSION; classic cmd/ConHost does not.
+    if std::env::var_os("WT_SESSION").is_some() {
+        return true;
+    }
+    // VTE-based terminals (GNOME Terminal, Tilix, …) advertise via VTE_VERSION ≥ 5000.
+    if let Ok(vte) = std::env::var("VTE_VERSION")
+        && let Ok(n) = vte.parse::<u32>()
+        && n >= 5000
+    {
+        return true;
+    }
+    // Non-Windows TTYs often support OSC 8 in modern emulators; keep the prior
+    // interactive behavior there. On Windows, require an explicit signal above.
+    #[cfg(not(windows))]
+    {
+        return true;
+    }
+    #[cfg(windows)]
+    {
+        false
+    }
 }
 
 /// Wrap `text` in the SGR `code` (e.g. `"1;32"`) when stdout coloring is

src/commands/arg_parser.rs

@@ -626,6 +626,7 @@ impl Repository {
                 &lines,
                 &request.line_ranges,
                 &request.options,
+                &commits_with_notes,
             )?;
         }
 
@@ -1702,6 +1703,7 @@ fn output_default_format(
     lines: &[&str],
     line_ranges: &[(u32, u32)],
     options: &AutterBlameOptions,
+    commits_with_notes: &std::collections::HashSet<String>,
 ) -> Result<(), AutterError> {
     let mut output = String::new();
 
@@ -1721,6 +1723,21 @@ fn output_default_format(
     let mut requested_lines: Vec<u32> = line_to_hunk.keys().copied().collect();
     requested_lines.sort_unstable();
 
+    // Lines shown as the git author because Autter has no note (and the commit
+    // isn't a known-agent email simulation). Used for the consistency notice.
+    let mut unattested_git_author_lines = 0usize;
+    if !options.mark_unknown {
+        for line_num in &requested_lines {
+            if let Some(hunk) = line_to_hunk.get(line_num)
+                && !commits_with_notes.contains(&hunk.commit_sha)
+                && crate::authorship::agent_detection::match_email_to_agent(&hunk.author_email)
+                    .is_none()
+            {
+                unattested_git_author_lines += 1;
+            }
+        }
+    }
+
     // Calculate the maximum line number width for proper padding
     let max_line_num = lines.len() as u32;
     let line_num_width = max_line_num.to_string().len();
@@ -1876,6 +1893,15 @@ fn output_default_format(
         output.push_str(stats);
     }
 
+    // Interactive TTY only: explain git-author fallback so blame doesn't look
+    // like it contradicts `autter stats` on the same commit. Keep porcelain /
+    // pager-piped / scripted output byte-compatible with git blame.
+    if unattested_git_author_lines > 0 && io::stdout().is_terminal() {
+        output.push_str(&crate::authorship::guidance::blame_git_author_fallback_notice(
+            unattested_git_author_lines,
+        ));
+    }
+
     // Output handling - respect pager environment variables
     let pager = std::env::var("GIT_PAGER")
         .or_else(|_| std::env::var("PAGER"))