@rosh100yx/outlier 0.4.24 → 0.4.25

package/README.md

@@ -50,9 +50,27 @@
                                  └───────────┘
 ```
 **Step 1:** Developer delegates code generation to an AI agent (Claude Code, Cursor).  
-**Step 2:** Developer attempts to merge code into the main branch.  
-**Step 3:** The `outlier` Bouncer hook triggers. If AI reliance > 70%, the commit is physically blocked.  
-**Step 4:** A "Mentoring Emergency" is triggered, forcing the developer to solve an architectural challenge to prove mastery and prevent deskilling.  
+**Step 2:** `outlier` reads the local trace — git history + AI logs — already on the machine.  
+**Step 3:** It reports who wrote the code, what it cost, and your authorship limit.  
+**Step 4:** Optionally, a local git hook *warns* (never silently blocks) when AI authorship exceeds your limit, so you review before you merge.  
+
+### What it reads (and what it doesn't)
+
+`outlier` is local-first. It reads, from your own machine, only:
+
+- **`git log`** of the current repo — to count commits carrying a `Co-Authored-By` trailer (the AI-authorship share).
+- **Your Claude Code session transcripts** at `~/.claude/projects/<this-repo>/*.jsonl` — to sum token usage for the cost / cache / carbon estimate. (Falls back to `~/.claude/tokenomics-log.jsonl` if present.)
+
+It does **not** send anything anywhere — no API calls, no telemetry, no account. Your code and prompts never leave the machine. The only network action in the whole tool is *you* choosing to open a share link or a feedback issue.
+
+### How accurate is it?
+
+We are deliberately honest about this:
+
+- **Authorship** is an exact count of trailer-tagged commits, but it is a *proxy* for real human-vs-AI effort, and it **under-counts** when your agent doesn't write the `Co-Authored-By` trailer. A surprisingly low number usually means missing trailers, not that you wrote everything.
+- **Tokens** are exact when the transcripts are present; otherwise the cost/carbon section reads zero.
+- **Cost ($)** is exact when the log carries a cost field, otherwise a *rough* blended token estimate (labelled as such).
+- **Carbon** is a rough estimate (inference energy varies ~4–20× in the literature) and the per-region figure is a *counterfactual* — cloud inference runs on the provider's grid, not yours. Treat it as an order-of-magnitude signal, not an audit.
 
 ## What Outlier Adds
 `outlier` builds a coordination layer on top of native agent workflows.

package/bin/outlier.js

@@ -165,7 +165,7 @@ var require_picocolors = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@rosh100yx/outlier",
-    version: "0.4.24",
+    version: "0.4.25",
     description: "AI Code Governance & Capability Auditing for the Terminal. Measures AI reliance, context waste, and enforces local CI/CD policies.",
     bin: {
       outlier: "bin/outlier.js"
@@ -1800,7 +1800,7 @@ async function getAuthorshipStats(repoPath = process.cwd()) {
 // src/carbon.ts
 import { homedir } from "os";
 import { join } from "path";
-import { readFile, access } from "fs/promises";
+import { readFile, access, readdir } from "fs/promises";
 // data/grid-factors.json
 var grid_factors_default = {
   vietnam: 681,
@@ -1813,10 +1813,50 @@ var grid_factors_default = {
 // src/carbon.ts
 class ClaudeLogParser {
   baseDir;
-  constructor(baseDir = homedir()) {
+  cwd;
+  constructor(baseDir = homedir(), cwd = process.cwd()) {
     this.baseDir = baseDir;
+    this.cwd = cwd;
   }
   async parse() {
+    const slug = this.cwd.replace(/\//g, "-");
+    const projectDir = join(this.baseDir, ".claude", "projects", slug);
+    try {
+      const files = (await readdir(projectDir)).filter((f2) => f2.endsWith(".jsonl"));
+      if (files.length > 0) {
+        let total2 = 0, output2 = 0, cache2 = 0;
+        const sessions2 = new Set;
+        for (const file of files) {
+          let text3 = "";
+          try {
+            text3 = await readFile(join(projectDir, file), "utf-8");
+          } catch {
+            continue;
+          }
+          for (const line of text3.split(`
+`)) {
+            if (!line.trim())
+              continue;
+            try {
+              const d = JSON.parse(line);
+              const u4 = d.message && d.message.usage || d.usage;
+              if (u4) {
+                const inp = u4.input_tokens || 0;
+                const out = u4.output_tokens || 0;
+                const cr = u4.cache_read_input_tokens || 0;
+                const cw = u4.cache_creation_input_tokens || 0;
+                total2 += inp + out + cr + cw;
+                output2 += out;
+                cache2 += cr;
+              }
+              if (d.sessionId)
+                sessions2.add(d.sessionId);
+            } catch {}
+          }
+        }
+        return { total: total2, output: output2, cache: cache2, sessions: sessions2.size, cost: 0 };
+      }
+    } catch {}
     const logPath = join(this.baseDir, ".claude", "tokenomics-log.jsonl");
     try {
       await access(logPath);
@@ -1824,11 +1864,12 @@ class ClaudeLogParser {
       return { total: 0, output: 0, cache: 0, sessions: 0, cost: 0 };
     }
     const text2 = await readFile(logPath, "utf-8");
-    const lines = text2.trim().split(`
-`).filter((l2) => l2.length > 0);
     let total = 0, output = 0, cache = 0, cost = 0;
     const sessions = new Set;
-    for (const line of lines) {
+    for (const line of text2.split(`
+`)) {
+      if (!line.trim())
+        continue;
       try {
         const data = JSON.parse(line);
         total += data.total_tokens || 0;
@@ -1837,7 +1878,7 @@ class ClaudeLogParser {
         cost += data.cost_usd || 0;
         if (data.session_id)
           sessions.add(data.session_id);
-      } catch (e) {}
+      } catch {}
     }
     return { total, output, cache, sessions: sessions.size, cost };
   }
@@ -2055,19 +2096,26 @@ async function main() {
 `));
   if (action === "--help" || action === "-h" || action === "help") {
     console.log(import_picocolors.default.bold(`
-COMMANDS:`));
-    console.log(`  ${import_picocolors.default.cyan("outlier")}              Interactive menu (Onboarding for first-timers)`);
-    console.log(`  ${import_picocolors.default.cyan("outlier status")}       Run full AI reliance & capability audit`);
-    console.log(`  ${import_picocolors.default.cyan("outlier authorship")}   Scan git history for AI co-authorship ratio`);
-    console.log(`  ${import_picocolors.default.cyan("outlier carbon")}       Scan local logs for token waste & carbon cost`);
-    console.log(`  ${import_picocolors.default.cyan("outlier policy")}       Configure CI/CD guardrails and thresholds`);
-    console.log(`  ${import_picocolors.default.cyan("outlier impact")}       See the compounding horizon of AI Deskilling`);
-    console.log(`  ${import_picocolors.default.cyan("outlier knowledge")}    Explore references, graphs, and the core literature`);
-    console.log(`  ${import_picocolors.default.cyan("outlier participate")}  Help build the academic literature on AI deskilling`);
-    console.log(`  ${import_picocolors.default.cyan("outlier init")}         Install the once-per-day shell greeting`);
-    console.log(`  ${import_picocolors.default.cyan("outlier uninit")}       Remove the shell greeting`);
+WHAT OUTLIER DOES`));
+    console.log(import_picocolors.default.dim("  Reads your local git history and AI logs — on your machine — to show"));
+    console.log(import_picocolors.default.dim(`  how much of your code AI wrote, what it cost, and how to keep your skill.
+`));
+    console.log(import_picocolors.default.bold("COMMANDS:"));
+    console.log(`  ${import_picocolors.default.cyan("outlier")}              Run the audit (the default — same as 'status')`);
+    console.log(`  ${import_picocolors.default.cyan("outlier status")}       Full audit: who wrote the code, what it cost, your limit`);
+    console.log(`  ${import_picocolors.default.cyan("outlier status --save")} Save the audit to ./outlier-audit.txt`);
+    console.log(`  ${import_picocolors.default.cyan("outlier authorship")}   Just the AI-vs-human commit breakdown`);
+    console.log(`  ${import_picocolors.default.cyan("outlier carbon")}       Just the token spend, cache waste & carbon`);
+    console.log(`  ${import_picocolors.default.cyan("outlier capabilities")} What tools & skills your agents can reach`);
+    console.log(`  ${import_picocolors.default.cyan("outlier policy")}       Set an AI-authorship limit (local git hook / CI)`);
+    console.log(`  ${import_picocolors.default.cyan("outlier impact")}       What AI reliance compounds to over time`);
+    console.log(`  ${import_picocolors.default.cyan("outlier knowledge")}    The research behind the metrics`);
+    console.log(`  ${import_picocolors.default.cyan("outlier participate")}  Share anonymous feedback for the deskilling study`);
+    console.log(`  ${import_picocolors.default.cyan("outlier init")}         Show a once-per-day reliance greeting in new shells`);
+    console.log(`  ${import_picocolors.default.cyan("outlier uninit")}       Remove that greeting`);
     console.log(`
-` + import_picocolors.default.dim("Run without arguments to start the interactive wizard."));
+` + import_picocolors.default.dim("Local-first: nothing ever leaves your machine."));
+    console.log(import_picocolors.default.dim("How it works → https://github.com/rosh100yx/outlier#how-it-works"));
     process.exit(0);
   }
   const configPath = join4(os2.homedir(), ".outlier_config");
@@ -2237,12 +2285,17 @@ Conservative Floor: ${color(nmPct + "%")}`, "Git Authorship Breakdown");
     s.stop("Audit complete");
     try {
       let authPct = "0%";
+      let nmFloorStr = "";
       let ruleFailures = 0;
       if (gitStats) {
         authPct = `${(gitStats.ratio * 100).toFixed(1)}%`;
+        nmFloorStr = ` ${import_picocolors.default.dim(`(${(gitStats.ratioNoMerges * 100).toFixed(0)}% excl. merges)`)}`;
         if (gitStats.ratio > 0.7)
           ruleFailures++;
       }
+      const lowTrailerWarn = gitStats && gitStats.ratio < 0.1 && carbon && carbon.totalTokens > 1e6 ? `
+ ${import_picocolors.default.dim("│")}   ${import_picocolors.default.dim("Low %? Your agent may not tag commits — outlier counts only")}
+ ${import_picocolors.default.dim("│")}   ${import_picocolors.default.dim("commits with a Co-Authored-By trailer.")}` : "";
       let cachePct = "0";
       let co2Str = "0.0kg";
       let regionStr = "Global Average";
@@ -2288,12 +2341,13 @@ Conservative Floor: ${color(nmPct + "%")}`, "Git Authorship Breakdown");
  ${import_picocolors.default.dim("│")} ${import_picocolors.default.cyan("█▄█ █▄█ ░█░ █▄▄ █ ██▄ █▀▄")}  ${import_picocolors.default.dim(`:: ${repoName} · ${dateStr}`)}
  ${import_picocolors.default.dim("├────────────────────────────────────────────────────────")}
  ${import_picocolors.default.dim("│")} ${import_picocolors.default.bold(import_picocolors.default.bgBlue(" WHO WROTE THE CODE "))}
- ${import_picocolors.default.dim("│")} AI    ${aiBar} ${authorshipStr}
+ ${import_picocolors.default.dim("│")} AI    ${aiBar} ${authorshipStr}${nmFloorStr}
  ${import_picocolors.default.dim("│")} You   ${humanBar} ${import_picocolors.default.bold(humanSov)}
+ ${import_picocolors.default.dim("│")} ${import_picocolors.default.dim("Typical: solo devs 10–40% · AI-framework repos up to ~80%")}
  ${import_picocolors.default.dim("│")}
  ${import_picocolors.default.dim("│")} ${verdictZone} — ${verdictText.split(`
 `).join(`
- ` + import_picocolors.default.dim("│") + "   ")}
+ ` + import_picocolors.default.dim("│") + "   ")}${lowTrailerWarn}
  ${import_picocolors.default.dim("├────────────────────────────────────────────────────────")}
  ${import_picocolors.default.dim("│")} ${import_picocolors.default.bold(import_picocolors.default.bgMagenta(" WHAT IT COST "))}
  ${import_picocolors.default.dim("│")} Tokens used      ${import_picocolors.default.bold(totalTokensStr)}
@@ -2309,8 +2363,9 @@ Conservative Floor: ${color(nmPct + "%")}`, "Git Authorship Breakdown");
  ${import_picocolors.default.dim("│")} AI cap   ${import_picocolors.default.bold("70%")} ${import_picocolors.default.dim("· change with: outlier policy")}
  ${import_picocolors.default.dim("│")} Status   ${policyStatus} ${import_picocolors.default.dim("·")} ${policyAction}
  ${import_picocolors.default.dim("├────────────────────────────────────────────────────────")}
- ${import_picocolors.default.dim("│")} ${import_picocolors.default.dim(import_picocolors.default.italic("Run this before you start. Keep the skill while you"))}
- ${import_picocolors.default.dim("│")} ${import_picocolors.default.dim(import_picocolors.default.italic("use the speed."))}
+ ${import_picocolors.default.dim("│")} ${import_picocolors.default.dim("Numbers are local estimates — authorship is a proxy and")}
+ ${import_picocolors.default.dim("│")} ${import_picocolors.default.dim("carbon is rough. How it works: outlier --help")}
+ ${import_picocolors.default.dim("│")} ${import_picocolors.default.dim(import_picocolors.default.italic("Run this before you start. Keep the skill while you use the speed."))}
  ${import_picocolors.default.dim("└────────────────────────────────────────────────────────")}`;
       } else {
         note(`status: ${authPct} AI Reliance | ${cachePct}% Cache Bloat | ${co2Str}`, `${import_picocolors.default.bold("[outlier]")} CI/CD Audit`);
@@ -2503,9 +2558,19 @@ ${import_picocolors.default.bold("Submit here (and drop your screenshot!):")} ${
 Read the full academic foundation at: ${import_picocolors.default.underline("https://github.com/rosh100yx/outlier")}
 `);
   }
-  outro("Local telemetry run completed. No data left your machine.");
+  outro("Done — nothing left your machine. (How it works: outlier --help)");
   if (typeof finalReceipt !== "undefined" && finalReceipt) {
     console.log(finalReceipt);
+    if (process.argv.includes("--save")) {
+      const stripAnsi = (s2) => s2.replace(/\x1b\[[0-9;]*m/g, "");
+      const savePath = join4(process.cwd(), "outlier-audit.txt");
+      try {
+        writeFileSync(savePath, stripAnsi(finalReceipt).trimStart() + `
+`);
+        console.log(import_picocolors.default.dim(`
+ \uD83D\uDCBE Saved to ${savePath}`));
+      } catch {}
+    }
   }
   if (action === "status") {
     const agent = detectAgent();
@@ -2516,10 +2581,14 @@ Read the full academic foundation at: ${import_picocolors.default.underline("htt
       console.log(import_picocolors.default.bold(import_picocolors.default.magenta(" ↳ Ready to code? ")) + "Start your AI agent");
     }
     console.log("");
-    console.log(import_picocolors.default.bold(import_picocolors.default.cyan(" └ Research: ")) + "Contribute to the AI deskilling study ➔ " + import_picocolors.default.bold("outlier participate"));
-    console.log(import_picocolors.default.bold(import_picocolors.default.green(" └ Share: ")) + import_picocolors.default.underline("https://x.com/intent/tweet?text=I+just+audited+my+codebase+with+%23Outlier"));
+    console.log(import_picocolors.default.bold(import_picocolors.default.green(" \uD83D\uDCF8 Share: ")) + "Screenshot this receipt, or post your score ➔ " + import_picocolors.default.underline("https://x.com/intent/tweet?text=I+just+audited+my+codebase+with+%23Outlier"));
+    console.log(import_picocolors.default.bold(import_picocolors.default.cyan(" \uD83D\uDD2C Research: ")) + "Help the AI-deskilling study — type:  " + import_picocolors.default.bold("outlier participate"));
+    if (!process.argv.includes("--save")) {
+      console.log(import_picocolors.default.dim(" \uD83D\uDCBE Save: outlier status --save"));
+    }
     console.log(import_picocolors.default.dim(`
- (To see all local governance modules, run: `) + import_picocolors.default.dim(import_picocolors.default.bold("outlier --help")) + import_picocolors.default.dim(")"));
+ outlier does more than this audit — see how you adopt AI, what it`));
+    console.log(import_picocolors.default.dim(" costs, and what is actually working:  ") + import_picocolors.default.bold(import_picocolors.default.cyan("outlier --help")));
   }
 }
 main().catch(console.error);

package/bin/postinstall.js

@@ -1,20 +1,21 @@
 #!/usr/bin/env node
 
-const cyan = (text) => `\x1b[36m${text}\x1b[0m`;
-const dim = (text) => `\x1b[2m${text}\x1b[0m`;
-const bold = (text) => `\x1b[1m${text}\x1b[0m`;
+const cyan = (t) => `\x1b[36m${t}\x1b[0m`;
+const dim = (t) => `\x1b[2m${t}\x1b[0m`;
+const bold = (t) => `\x1b[1m${t}\x1b[0m`;
+const green = (t) => `\x1b[32m${t}\x1b[0m`;
 
-console.log('\n' + bold('Welcome to Outlier') + ' - AI Code Governance for the Terminal');
-console.log(dim('────────────────────────────────────────────────────────────'));
-console.log('To start the interactive wizard and audit your codebase, type:\n');
-console.log(`  ${cyan('outlier')}\n`);
-console.log('Available Commands:');
-console.log(`  ${cyan('outlier status')}        Run full AI reliance & capability audit`);
-console.log(`  ${cyan('outlier authorship')}    Scan git history for AI co-authorship ratio`);
-console.log(`  ${cyan('outlier carbon')}        Scan local logs for token waste & carbon cost`);
-console.log(`  ${cyan('outlier capabilities')}  Audit active MCPs, skills, and orchestrations`);
-console.log(`  ${cyan('outlier policy')}        Configure CI/CD guardrails and thresholds`);
-console.log(`  ${cyan('outlier impact')}        See the compounding horizon of AI Deskilling`);
-console.log(`  ${cyan('outlier knowledge')}     Explore core literature and METR references`);
-console.log(`  ${cyan('outlier participate')}   Help build the literature on AI deskilling`);
-console.log(dim('────────────────────────────────────────────────────────────\n'));
+console.log('\n' + bold('  Outlier installed') + dim(' · AI code governance for the terminal'));
+console.log(dim('  ──────────────────────────────────────────────────────────'));
+console.log('  Run it before you start coding. It reads your local git history');
+console.log('  and AI logs — ' + green('on your machine') + ' — and shows you:');
+console.log('    • how much of your code AI wrote');
+console.log('    • what it cost (tokens, $, wasted context, carbon)');
+console.log('    • whether you are keeping the skill while you use the speed');
+console.log('');
+console.log('  Start your first audit:');
+console.log(`      ${cyan('outlier')}`);
+console.log('');
+console.log('  Other commands:  ' + dim('outlier --help'));
+console.log(dim('  ──────────────────────────────────────────────────────────'));
+console.log('  ' + green('Local-first:') + ' nothing ever leaves your machine.\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rosh100yx/outlier",
-  "version": "0.4.24",
+  "version": "0.4.25",
   "description": "AI Code Governance & Capability Auditing for the Terminal. Measures AI reliance, context waste, and enforces local CI/CD policies.",
   "bin": {
     "outlier": "bin/outlier.js"

package/src/carbon.ts

@@ -1,6 +1,6 @@
 import { homedir } from 'os';
 import { join } from 'path';
-import { readFile, access } from 'fs/promises';
+import { readFile, access, readdir } from 'fs/promises';
 import gridFactors from '../data/grid-factors.json';
 
 export interface CarbonStats {
@@ -23,33 +23,70 @@ export interface TokenLogParser {
 
 export class ClaudeLogParser implements TokenLogParser {
   private baseDir: string;
-  constructor(baseDir = homedir()) {
+  private cwd: string;
+  constructor(baseDir = homedir(), cwd = process.cwd()) {
     this.baseDir = baseDir;
+    this.cwd = cwd;
   }
+
   async parse() {
+    // Primary source: the standard Claude Code session transcripts for THIS repo.
+    // Claude Code stores them at ~/.claude/projects/<cwd-with-slashes-as-dashes>/*.jsonl,
+    // one JSON object per line; assistant turns carry `message.usage`.
+    const slug = this.cwd.replace(/\//g, '-');
+    const projectDir = join(this.baseDir, '.claude', 'projects', slug);
+    try {
+      const files = (await readdir(projectDir)).filter(f => f.endsWith('.jsonl'));
+      if (files.length > 0) {
+        let total = 0, output = 0, cache = 0;
+        const sessions = new Set<string>();
+        for (const file of files) {
+          let text = '';
+          try { text = await readFile(join(projectDir, file), 'utf-8'); } catch { continue; }
+          for (const line of text.split('\n')) {
+            if (!line.trim()) continue;
+            try {
+              const d = JSON.parse(line);
+              const u = (d.message && d.message.usage) || d.usage;
+              if (u) {
+                const inp = u.input_tokens || 0;
+                const out = u.output_tokens || 0;
+                const cr = u.cache_read_input_tokens || 0;
+                const cw = u.cache_creation_input_tokens || 0;
+                total += inp + out + cr + cw;
+                output += out;
+                cache += cr;
+              }
+              if (d.sessionId) sessions.add(d.sessionId);
+            } catch {}
+          }
+        }
+        // Standard transcripts carry no cost field; cost is estimated downstream.
+        return { total, output, cache, sessions: sessions.size, cost: 0 };
+      }
+    } catch {}
+
+    // Fallback: the optional tokenomics-log.jsonl (written by a custom Stop hook;
+    // carries a real cost_usd field when present).
     const logPath = join(this.baseDir, '.claude', 'tokenomics-log.jsonl');
-    
     try {
       await access(logPath);
     } catch {
       return { total: 0, output: 0, cache: 0, sessions: 0, cost: 0 };
     }
-
     const text = await readFile(logPath, 'utf-8');
-    const lines = text.trim().split('\n').filter(l => l.length > 0);
-
     let total = 0, output = 0, cache = 0, cost = 0;
     const sessions = new Set<string>();
-
-    for (const line of lines) {
+    for (const line of text.split('\n')) {
+      if (!line.trim()) continue;
       try {
         const data = JSON.parse(line);
         total += data.total_tokens || 0;
         output += data.output_tokens || 0;
         cache += data.cache_read || 0;
-        cost += data.cost_usd || 0; // present when the log was written with a cost field
+        cost += data.cost_usd || 0;
         if (data.session_id) sessions.add(data.session_id);
-      } catch (e) {}
+      } catch {}
     }
     return { total, output, cache, sessions: sessions.size, cost };
   }

package/src/cli.ts

@@ -84,18 +84,24 @@ async function main() {
   
   
   if (action === '--help' || action === '-h' || action === 'help') {
-    console.log(pc.bold('\nCOMMANDS:'));
-    console.log(`  ${pc.cyan('outlier')}              Interactive menu (Onboarding for first-timers)`);
-    console.log(`  ${pc.cyan('outlier status')}       Run full AI reliance & capability audit`);
-    console.log(`  ${pc.cyan('outlier authorship')}   Scan git history for AI co-authorship ratio`);
-    console.log(`  ${pc.cyan('outlier carbon')}       Scan local logs for token waste & carbon cost`);
-    console.log(`  ${pc.cyan('outlier policy')}       Configure CI/CD guardrails and thresholds`);
-    console.log(`  ${pc.cyan('outlier impact')}       See the compounding horizon of AI Deskilling`);
-    console.log(`  ${pc.cyan('outlier knowledge')}    Explore references, graphs, and the core literature`);
-    console.log(`  ${pc.cyan('outlier participate')}  Help build the academic literature on AI deskilling`);
-    console.log(`  ${pc.cyan('outlier init')}         Install the once-per-day shell greeting`);
-    console.log(`  ${pc.cyan('outlier uninit')}       Remove the shell greeting`);
-    console.log('\n' + pc.dim('Run without arguments to start the interactive wizard.'));
+    console.log(pc.bold('\nWHAT OUTLIER DOES'));
+    console.log(pc.dim('  Reads your local git history and AI logs — on your machine — to show'));
+    console.log(pc.dim('  how much of your code AI wrote, what it cost, and how to keep your skill.\n'));
+    console.log(pc.bold('COMMANDS:'));
+    console.log(`  ${pc.cyan('outlier')}              Run the audit (the default — same as 'status')`);
+    console.log(`  ${pc.cyan('outlier status')}       Full audit: who wrote the code, what it cost, your limit`);
+    console.log(`  ${pc.cyan('outlier status --save')} Save the audit to ./outlier-audit.txt`);
+    console.log(`  ${pc.cyan('outlier authorship')}   Just the AI-vs-human commit breakdown`);
+    console.log(`  ${pc.cyan('outlier carbon')}       Just the token spend, cache waste & carbon`);
+    console.log(`  ${pc.cyan('outlier capabilities')} What tools & skills your agents can reach`);
+    console.log(`  ${pc.cyan('outlier policy')}       Set an AI-authorship limit (local git hook / CI)`);
+    console.log(`  ${pc.cyan('outlier impact')}       What AI reliance compounds to over time`);
+    console.log(`  ${pc.cyan('outlier knowledge')}    The research behind the metrics`);
+    console.log(`  ${pc.cyan('outlier participate')}  Share anonymous feedback for the deskilling study`);
+    console.log(`  ${pc.cyan('outlier init')}         Show a once-per-day reliance greeting in new shells`);
+    console.log(`  ${pc.cyan('outlier uninit')}       Remove that greeting`);
+    console.log('\n' + pc.dim('Local-first: nothing ever leaves your machine.'));
+    console.log(pc.dim('How it works → https://github.com/rosh100yx/outlier#how-it-works'));
     process.exit(0);
   }
 
@@ -275,13 +281,23 @@ Conservative Floor: ${color(nmPct + '%')}`,
     
     try {
         let authPct = '0%';
+        let nmFloorStr = '';
         let ruleFailures = 0;
 
         if (gitStats) {
           authPct = `${(gitStats.ratio * 100).toFixed(1)}%`;
+          // Conservative floor: non-merge commits only (merges often lack the trailer).
+          nmFloorStr = ` ${pc.dim(`(${(gitStats.ratioNoMerges * 100).toFixed(0)}% excl. merges)`)}`;
           if (gitStats.ratio > 0.7) ruleFailures++;
         }
 
+        // Honesty: a very low ratio alongside heavy token use usually means the agent
+        // doesn't tag commits, not that the human wrote everything.
+        const lowTrailerWarn =
+          gitStats && gitStats.ratio < 0.1 && carbon && carbon.totalTokens > 1_000_000
+            ? `\n ${pc.dim('│')}   ${pc.dim('Low %? Your agent may not tag commits — outlier counts only')}\n ${pc.dim('│')}   ${pc.dim('commits with a Co-Authored-By trailer.')}`
+            : '';
+
         let cachePct = '0';
         let co2Str = '0.0kg';
         let regionStr = 'Global Average';
@@ -344,10 +360,11 @@ Conservative Floor: ${color(nmPct + '%')}`,
  ${pc.dim('│')} ${pc.cyan('█▄█ █▄█ ░█░ █▄▄ █ ██▄ █▀▄')}  ${pc.dim(`:: ${repoName} · ${dateStr}`)}
  ${pc.dim('├────────────────────────────────────────────────────────')}
  ${pc.dim('│')} ${pc.bold(pc.bgBlue(' WHO WROTE THE CODE '))}
- ${pc.dim('│')} AI    ${aiBar} ${authorshipStr}
+ ${pc.dim('│')} AI    ${aiBar} ${authorshipStr}${nmFloorStr}
  ${pc.dim('│')} You   ${humanBar} ${pc.bold(humanSov)}
+ ${pc.dim('│')} ${pc.dim('Typical: solo devs 10–40% · AI-framework repos up to ~80%')}
  ${pc.dim('│')}
- ${pc.dim('│')} ${verdictZone} — ${verdictText.split('\n').join('\n ' + pc.dim('│') + '   ')}
+ ${pc.dim('│')} ${verdictZone} — ${verdictText.split('\n').join('\n ' + pc.dim('│') + '   ')}${lowTrailerWarn}
  ${pc.dim('├────────────────────────────────────────────────────────')}
  ${pc.dim('│')} ${pc.bold(pc.bgMagenta(' WHAT IT COST '))}
  ${pc.dim('│')} Tokens used      ${pc.bold(totalTokensStr)}
@@ -361,8 +378,9 @@ Conservative Floor: ${color(nmPct + '%')}`,
  ${pc.dim('│')} AI cap   ${pc.bold('70%')} ${pc.dim('· change with: outlier policy')}
  ${pc.dim('│')} Status   ${policyStatus} ${pc.dim('·')} ${policyAction}
  ${pc.dim('├────────────────────────────────────────────────────────')}
- ${pc.dim('│')} ${pc.dim(pc.italic('Run this before you start. Keep the skill while you'))}
- ${pc.dim('│')} ${pc.dim(pc.italic('use the speed.'))}
+ ${pc.dim('│')} ${pc.dim('Numbers are local estimates — authorship is a proxy and')}
+ ${pc.dim('│')} ${pc.dim('carbon is rough. How it works: outlier --help')}
+ ${pc.dim('│')} ${pc.dim(pc.italic('Run this before you start. Keep the skill while you use the speed.'))}
  ${pc.dim('└────────────────────────────────────────────────────────')}`;
         } else {
             note(
@@ -566,10 +584,20 @@ Artifact:     ${pc.cyan(reportPath)}`,
     console.log(`\nRead the full academic foundation at: ${pc.underline('https://github.com/rosh100yx/outlier')}\n`);
   }
 
-  outro('Local telemetry run completed. No data left your machine.');
+  outro('Done — nothing left your machine. (How it works: outlier --help)');
 
   if (typeof finalReceipt !== 'undefined' && finalReceipt) {
     console.log(finalReceipt);
+
+    // --save: write a plain-text (no color) copy of the receipt next to the repo.
+    if (process.argv.includes('--save')) {
+      const stripAnsi = (s: string) => s.replace(/\x1b\[[0-9;]*m/g, '');
+      const savePath = join(process.cwd(), 'outlier-audit.txt');
+      try {
+        writeFileSync(savePath, stripAnsi(finalReceipt).trimStart() + '\n');
+        console.log(pc.dim(`\n 💾 Saved to ${savePath}`));
+      } catch {}
+    }
   }
 
   if (action === 'status') {
@@ -586,13 +614,20 @@ Artifact:     ${pc.cyan(reportPath)}`,
     }
     console.log('');
     console.log(
-      pc.bold(pc.cyan(' └ Research: ')) + 'Contribute to the AI deskilling study ➔ ' + pc.bold('outlier participate')
+      pc.bold(pc.green(' 📸 Share: ')) + 'Screenshot this receipt, or post your score ➔ ' +
+      pc.underline('https://x.com/intent/tweet?text=I+just+audited+my+codebase+with+%23Outlier')
     );
     console.log(
-      pc.bold(pc.green(' └ Share: ')) + pc.underline('https://x.com/intent/tweet?text=I+just+audited+my+codebase+with+%23Outlier')
+      pc.bold(pc.cyan(' 🔬 Research: ')) + 'Help the AI-deskilling study — type:  ' + pc.bold('outlier participate')
+    );
+    if (!process.argv.includes('--save')) {
+      console.log(pc.dim(' 💾 Save: outlier status --save'));
+    }
+    console.log(
+      pc.dim('\n outlier does more than this audit — see how you adopt AI, what it')
     );
     console.log(
-      pc.dim('\n (To see all local governance modules, run: ') + pc.dim(pc.bold('outlier --help')) + pc.dim(')')
+      pc.dim(' costs, and what is actually working:  ') + pc.bold(pc.cyan('outlier --help'))
     );
   }
 }