@rosh100yx/outlier 0.4.2 → 0.4.10

package/README.md

@@ -4,20 +4,17 @@
   <p><b>The Governance & Policy Engine for AI Engineering</b></p>
   <p><i>Measure AI adoption. Enforce Zero-Trust. Protect Human Mastery.</i></p>
   <br/>
-  <a href="https://github.com/rosh100yx/outlier/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.md&title=%5BFEATURE%5D+">
-    <img src="https://img.shields.io/badge/%E2%9C%A8_Feature_Request-Submit_an_idea-blueviolet?style=for-the-badge&logo=github" alt="Feature Request" />
-  </a>
   
   <p>
     <img src="https://img.shields.io/badge/Compliance-Strict-blue?style=for-the-badge" />
     <img src="https://img.shields.io/badge/AI_Safety-Enabled-green?style=for-the-badge" />
     <img src="https://img.shields.io/badge/Zero_Trust-Verified-orange?style=for-the-badge" />
-    <img src="https://img.shields.io/badge/Carbon_Footprint-Tracked-lightgrey?style=for-the-badge" />
   </p>
 
   <p>
     <b>Get Started Instantly:</b><br/>
-    <code>npx @rosh100yx/outlier status</code>
+    <code>npm install -g @rosh100yx/outlier</code><br/>
+    <code>outlier status</code>
   </p>
 
   <br/>
@@ -25,20 +22,6 @@
   <br/>
 </div>
 
-`outlier` is an open-source, local-first policy engine and governance framework designed to measure the true cost and risk of AI code generation. As teams accelerate with LLM agents (Cursor, Copilot, Claude Code), `outlier` acts as the definitive **Bouncer**—auditing AI authorship, mitigating deskilling risks, and tracking regional carbon footprints entirely locally. 
-
-**Our Moat:**
-1. **Zero-Trust & Local-First:** No API keys, no telemetry sent to the cloud. `outlier` reads your native `~/.claude/` session logs and `.git/` history directly on your machine.
-2. **Actionable Policy Engine:** We don't just build dashboards. `outlier` lives in your terminal and CI/CD pipelines (via pre-commit hooks and GitHub Actions), physically blocking risky or overly AI-reliant commits.
-3. **Counterfactual Carbon Accounting:** The only observability tool mapping token cache waste directly to your local energy grid (e.g., Global South vs EU), proving true environmental impacts.
-4. **Anti-Deskilling Guardrails:** Built to prevent developers from becoming mere spectators in their own codebase.
-
-> *"In a room full of agents" shifts the perspective. It acknowledges that the developer is no longer a solo coder; they are a manager of bots. The product exists to make sure the human doesn't get lazy while managing them. We all want our time back, but we don't want to lose control of the craft.*
-
-<div align="center">
-  <img src="https://raw.githubusercontent.com/rosh100yx/outlier/main/assets/codecore.gif" alt="Codecore Aesthetic" width="300" />
-</div>
-
 ## How It Works
 ```text
 ┌───────────┐   ┌────────────┐   ┌───────────┐   ┌─────────────┐
@@ -130,5 +113,26 @@ This tool is the technical implementation of an ongoing academic thesis on the t
 
 See our [Contributing Guide](CONTRIBUTING.md) to get started. Great first issues include adding new regional grid factors to `data/grid-factors.json` or writing custom CI/CD pipeline integrations.
 
+## The Compounding Horizon of AI Deskilling
+
+When you use an AI agent to skip the boring stuff today, it feels amazing. You get your time back. But what happens over the next 5 to 10 years? 
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/rosh100yx/outlier/main/assets/metr-long-tasks.png" alt="METR Graph" width="350" />
+  <p><i>Source: METR (Measuring AI Ability to Complete Long Tasks)</i></p>
+</div>
+
+### What Does This Mean For Developers?
+- **Today (The 5-minute task):** You gain speed. You lose the muscle memory of writing low-level code.
+- **Tomorrow (The 5-hour task):** Agents will solve complex tickets across multiple files. You gain massive scale. You lose the deep, intimate understanding of your own system's architecture.
+- **Next 5-10 Years (The 1M+ LOC Crisis):** When an agent introduces a critical bug in a massive codebase, human reviewers will lack the deeply ingrained "systems thinking" required to debug it. 
+
+### Why This Project Exists
+`outlier` is the technical circuit breaker that forces developers to stay sharp. We measure the exact cost of AI for humans—not just in API tokens burnt, but in cognitive load and lost mastery. 
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/rosh100yx/outlier/main/assets/codecore.gif" alt="Codecore Aesthetic" width="300" />
+</div>
+
 ## License
 MIT License

package/bin/outlier.js

@@ -161,6 +161,63 @@ var require_picocolors = __commonJS((exports, module) => {
   module.exports.createColors = createColors;
 });
 
+// package.json
+var require_package = __commonJS((exports, module) => {
+  module.exports = {
+    name: "@rosh100yx/outlier",
+    version: "0.4.10",
+    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"
+    },
+    files: [
+      "bin/outlier.js",
+      "bin/postinstall.js",
+      "src",
+      "data"
+    ],
+    scripts: {
+      build: "bun build ./src/cli.ts --target=node --outfile bin/outlier.js",
+      test: "bun test",
+      start: "bun run src/cli.ts",
+      postinstall: "node bin/postinstall.js"
+    },
+    type: "module",
+    private: false,
+    author: "Roshan Abraham",
+    license: "MIT",
+    repository: {
+      type: "git",
+      url: "https://github.com/rosh100yx/outlier.git"
+    },
+    keywords: [
+      "ai",
+      "governance",
+      "carbon",
+      "compliance",
+      "ai-safety",
+      "policy-engine",
+      "zero-trust",
+      "carbon-footprint",
+      "global-south",
+      "observability",
+      "telemetry",
+      "authorship",
+      "cli"
+    ],
+    devDependencies: {
+      "@types/bun": "latest"
+    },
+    peerDependencies: {
+      typescript: "^5"
+    },
+    dependencies: {
+      "@clack/prompts": "^1.6.0",
+      picocolors: "^1.1.1"
+    }
+  };
+});
+
 // node_modules/@clack/core/dist/index.mjs
 import { styleText } from "node:util";
 import { stdout, stdin } from "node:process";
@@ -1932,7 +1989,8 @@ The results will assign you a "vibe" and evaluate if you are at risk of deskilli
 async function main() {
   console.clear();
   console.log(import_picocolors.default.cyan(ASCII_LOGO));
-  console.log(import_picocolors.default.dim(`  Outlier v0.4.1 · AI Code Reliance & Telemetry Engine
+  const pkg = require_package();
+  console.log(import_picocolors.default.dim(`  Outlier v${pkg.version} · AI Code Reliance & Telemetry Engine
 `));
   let action = process.argv[2];
   if (action === "--help" || action === "-h" || action === "help") {
@@ -1943,7 +2001,9 @@ COMMANDS:`));
     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 confessional")} Submit qualitative feedback or feature requests`);
+    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.dim("Run without arguments to start the interactive wizard."));
     process.exit(0);
@@ -1964,7 +2024,9 @@ COMMANDS:`));
           { value: "authorship", label: "Code Durability", hint: "Scan git history for AI Code Reliance & Hallucination Risk" },
           { value: "carbon", label: "Cache Bloat", hint: "Scan local logs for context waste & token costs" },
           { value: "policy", label: "Policy Profiles", hint: "Set Personal, Team, or Enterprise guardrails in CI" },
-          { value: "confessional", label: "Confessional", hint: "Tell us how AI is really affecting your job (Feature Requests)" }
+          { value: "impact", label: "Impact Horizon", hint: "What do you lose and gain in the next 5-10 years?" },
+          { value: "knowledge", label: "Literature Base", hint: "Explore references and the core academic foundation" },
+          { value: "participate", label: "Participate", hint: "Contribute to the literature on AI deskilling" }
         ]
       });
       if (isCancel(action)) {
@@ -2110,6 +2172,74 @@ ${costIcon}${import_picocolors.default.dim("[3] Tokenomics & Cost")} ${import_pi
     waste: ${import_picocolors.default.yellow(`⚠ ${cachePct}% of tokens are redundant context reads`)}
     carbon: ${import_picocolors.default.green(`✓ ${co2Str} (Est. ${regionStr} Grid)`)}
 ${import_picocolors.default.bold("Governance:")} ${ruleFailures > 0 ? import_picocolors.default.red(`${failIcon} ${ruleFailures + 1} policy failures`) : import_picocolors.default.green(`${passIcon} All clear`)}`, `${import_picocolors.default.bold("[outlier]")} ${5 - (ruleFailures + 1)}/5 policies • ${authWarning || import_picocolors.default.green(`${passIcon} safe surface`)} • ${co2Str}`);
+      const timestamp = new Date().toISOString().split("T")[0];
+      const isDanger = gitStats && gitStats.ratio > 0.7;
+      const verdictZone = isDanger ? import_picocolors.default.red("DANGER ZONE") : import_picocolors.default.green("SAFE / SOVEREIGN");
+      const verdictText = isDanger ? `You are transitioning from 'Creator' to 'Reviewer'.
+   At this trajectory, you risk losing architectural 
+   muscle memory on this codebase within 6 months.` : `You are maintaining strong architectural intimacy.
+   Your human judgement remains the primary driver
+   of logic in this system.`;
+      const isInefficient = parseFloat(cachePct) > 40;
+      const cacheVerdict = isInefficient ? import_picocolors.default.yellow("INEFFICIENT") : import_picocolors.default.green("EFFICIENT");
+      const cacheText = isInefficient ? `You are burning paid API tokens and excess compute
+   on files the agent isn't even touching.` : `Your token usage and human judgment are tightly
+   coupled. High signal-to-noise ratio.`;
+      const policyStatus = ruleFailures > 0 ? import_picocolors.default.red("BLOCKED \uD83D\uDED1 (Threshold Exceeded)") : import_picocolors.default.green("PASS ✅ (Within Threshold)");
+      const policyAction = ruleFailures > 0 ? "Triggering Mandatory Mentoring Scenario." : "No intervention required.";
+      const totalTokensStr = carbon ? (carbon.totalTokens / 1000).toFixed(1) + "k" : "0";
+      const humanSov = gitStats ? ((1 - gitStats.ratio) * 100).toFixed(1) + "%" : "100%";
+      const authorshipStr = authPct + (isDanger ? import_picocolors.default.red(" (High Reliance)") : import_picocolors.default.green(" (Healthy)"));
+      const getProgressBar = (pct, length = 10) => {
+        const filled = Math.max(0, Math.min(length, Math.round(pct / 100 * length)));
+        return "▰".repeat(filled) + "▱".repeat(length - filled);
+      };
+      const aiPctVal = gitStats ? gitStats.ratio * 100 : 0;
+      const aiBar = import_picocolors.default.yellow(getProgressBar(aiPctVal));
+      const humanBar = import_picocolors.default.cyan(getProgressBar(100 - aiPctVal));
+      const cacheBar = import_picocolors.default.magenta(getProgressBar(parseFloat(cachePct) || 0));
+      if (!isStrict) {
+        const dateStr = new Date().toLocaleDateString("en-US", { month: "short", day: "2-digit", year: "numeric" }).toUpperCase();
+        const timeStr = new Date().toLocaleTimeString("en-US", { hour12: false });
+        const repoName = process.cwd().split("/").pop() || "Unknown";
+        console.log(`
+ ${import_picocolors.default.dim("┌────────────────────────────────────────────────────────")}
+ ${import_picocolors.default.dim("│")} ${import_picocolors.default.cyan("█▀█ █░█ ▀█▀ █░░ █ █▀▀ █▀█")}  ${import_picocolors.default.bold(":: THERMAL AUDIT RECEIPT")}
+ ${import_picocolors.default.dim("│")} ${import_picocolors.default.cyan("█▄█ █▄█ ░█░ █▄▄ █ ██▄ █▀▄")}  ${import_picocolors.default.dim(`:: TIMESTAMP: ${dateStr}`)}
+ ${import_picocolors.default.dim("├────────────────────────────────────────────────────────")}
+ ${import_picocolors.default.dim("│")} ${import_picocolors.default.bold(import_picocolors.default.bgBlue(" [ COGNITIVE BUDGET ] "))}
+ ${import_picocolors.default.dim("│")} AI Authorship     ................. ${aiBar} ${authorshipStr}
+ ${import_picocolors.default.dim("│")} Human Sovereignty ................. ${humanBar} ${humanSov}
+ ${import_picocolors.default.dim("│")}
+ ${import_picocolors.default.dim("│")} ↳ Verdict: ${verdictZone}
+ ${import_picocolors.default.dim("│")}   ${verdictText.split(`
+`).join(`
+ ` + import_picocolors.default.dim("│") + " ")}
+ ${import_picocolors.default.dim("├────────────────────────────────────────────────────────")}
+ ${import_picocolors.default.dim("│")} ${import_picocolors.default.bold(import_picocolors.default.bgMagenta(" [ FINANCIAL & COMPUTE TOLL ] "))}
+ ${import_picocolors.default.dim("│")} Tokens Burnt      ................. ${totalTokensStr} vs Human Judgment
+ ${import_picocolors.default.dim("│")} Cache Bloat       ................. ${cacheBar} ${cachePct}% (Unmodified context)
+ ${import_picocolors.default.dim("│")} Regional Grid     ................. ${regionStr}
+ ${import_picocolors.default.dim("│")}
+ ${import_picocolors.default.dim("│")} ↳ Verdict: ${cacheVerdict}
+ ${import_picocolors.default.dim("│")}   ${cacheText.split(`
+`).join(`
+ ` + import_picocolors.default.dim("│") + " ")}
+ ${import_picocolors.default.dim("├────────────────────────────────────────────────────────")}
+ ${import_picocolors.default.dim("│")} ${import_picocolors.default.bold(import_picocolors.default.bgYellow(import_picocolors.default.black(" [ POLICY ENFORCEMENT ] ")))}
+ ${import_picocolors.default.dim("│")} Status .................................. ${policyStatus}
+ ${import_picocolors.default.dim("│")} Action .................................. ${policyAction}
+ ${import_picocolors.default.dim("├────────────────────────────────────────────────────────")}
+ ${import_picocolors.default.dim("│")}
+ ${import_picocolors.default.dim("│")}  ${import_picocolors.default.italic(import_picocolors.default.dim("patterns emerge in the commit history,"))}
+ ${import_picocolors.default.dim("│")}  ${import_picocolors.default.italic(import_picocolors.default.dim("code becomes commoditized by algorithms."))}
+ ${import_picocolors.default.dim("│")}  ${import_picocolors.default.italic(import_picocolors.default.dim("human mastery is the only true moat."))}
+ ${import_picocolors.default.dim("│")}
+ ${import_picocolors.default.dim("│")}                   ${import_picocolors.default.bold(import_picocolors.default.cyan("***STAY VIGILANT***"))}
+ ${import_picocolors.default.dim("└────────────────────────────────────────────────────────")}`);
+      } else {
+        note(`status: ${authPct} AI Reliance | ${cachePct}% Cache Bloat | ${co2Str}`, `${import_picocolors.default.bold("[outlier]")} CI/CD Audit`);
+      }
     } catch (e) {
       s.stop("Audit failed");
       console.error(import_picocolors.default.red(e.message));
@@ -2217,8 +2347,8 @@ Status:       ${import_picocolors.default.green("Compliant - Human oversight log
 Privacy:      ${import_picocolors.default.green("Preserved - No citizen data exported")}
 Artifact:     ${import_picocolors.default.cyan(reportPath)}`, "Regulatory Compliance");
     }
-  } else if (action === "confessional") {
-    s.start("Connecting to the human element...");
+  } else if (action === "participate") {
+    s.start("Connecting to the Outlier research project...");
     await new Promise((resolve) => setTimeout(resolve, 600));
     s.stop("Secure connection established.");
     const q1 = await select({
@@ -2230,7 +2360,7 @@ Artifact:     ${import_picocolors.default.cyan(reportPath)}`, "Regulatory Compli
       ]
     });
     if (isCancel(q1)) {
-      cancel("Confession aborted.");
+      cancel("Survey aborted.");
       process.exit(0);
     }
     const q2 = await select({
@@ -2242,7 +2372,7 @@ Artifact:     ${import_picocolors.default.cyan(reportPath)}`, "Regulatory Compli
       ]
     });
     if (isCancel(q2)) {
-      cancel("Confession aborted.");
+      cancel("Survey aborted.");
       process.exit(0);
     }
     const feedback = await text({
@@ -2251,62 +2381,60 @@ Artifact:     ${import_picocolors.default.cyan(reportPath)}`, "Regulatory Compli
       placeholder: "Honestly, I just let the agent write the regex...",
       validate(value) {
         if (!value || value.length === 0)
-          return `C'mon, confess something!`;
+          return `C'mon, say something!`;
       }
     });
     if (isCancel(feedback)) {
-      cancel("Confession aborted.");
+      cancel("Survey aborted.");
       process.exit(0);
     }
     note(`${import_picocolors.default.italic(`"${feedback}"`)}
 
-Your confession is safe with us. But if you want to make it official (and help us build what you need for the literature), we've generated a secure transmission link for you.`, "The Confessional");
+Your input is invaluable. To make it official and contribute to the literature, we've generated a secure transmission link for you.`, "Outlier Research");
     const surveyData = `**Engineering Reality:** ${q1}
 **Deskilling Impact:** ${q2}
 **Thoughts:**
 ${feedback}`;
-    const url = `https://github.com/rosh100yx/outlier/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.md&title=%5BConfessional%5D+Feedback&body=${encodeURIComponent(`Drop a screenshot of your Thermal Receipt here! 
+    const url = `https://github.com/rosh100yx/outlier/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.md&title=%5BOutlier+Research%5D+Feedback&body=${encodeURIComponent(`Drop a screenshot of your Thermal Receipt here! 
 
 ` + surveyData)}`;
     console.log(`
 ${import_picocolors.default.bold("Submit here (and drop your screenshot!):")} ${import_picocolors.default.underline(import_picocolors.default.cyan(url))}
 `);
-  }
-  outro("Local telemetry run completed. No data left your machine.");
-  if (action === "status" || action === "authorship" || action === "carbon") {
-    const d = new Date;
-    const dateStr = d.toLocaleDateString("en-US", { month: "short", day: "2-digit", year: "numeric" }).toUpperCase();
-    const timeStr = d.toLocaleTimeString("en-US", { hour12: false });
-    let repoName = process.cwd().split("/").pop() || "Unknown";
-    console.log(`
-${import_picocolors.default.dim("-------------------------")} ${import_picocolors.default.bold("AUDIT RECEIPT")} ${import_picocolors.default.dim("-------------------------")}`);
+  } else if (action === "impact") {
     console.log(`
- Project                                      ${import_picocolors.default.bold(repoName.padEnd(16).substring(0, 16))}`);
-    console.log(` Timestamp                                  ${import_picocolors.default.dim(`${dateStr} ${timeStr}`)}
+` + import_picocolors.default.bold(import_picocolors.default.bgMagenta(" THE COMPOUNDING HORIZON OF DESKILLING ")) + `
 `);
-    console.log(` 01x Authorship Policy                      ${process.argv.includes("--strict") ? "Strict Mode" : "Vibe Check"}`);
-    console.log(` 02x AI Reliance Risk                       ${action === "carbon" ? "N/A" : "Assessed"}`);
-    console.log(` 03x Cache Bloat Tokens                     ${action === "authorship" ? "N/A" : "Audited"}`);
-    console.log(` 04x Regional Grid Check                    ${action === "authorship" ? "N/A" : "Completed"}
+    console.log(import_picocolors.default.bold("What Do We Lose and Gain?"));
+    console.log(import_picocolors.default.cyan("■ Today (The 5-minute task)"));
+    console.log(`  ${import_picocolors.default.green("Gain:")} Velocity. AI scaffolds your components.`);
+    console.log(`  ${import_picocolors.default.red("Lose:")} Syntax recall. Memory of the low-level pipes.`);
+    console.log(import_picocolors.default.cyan(`
+■ Tomorrow (The 5-hour task - e.g. Claude Opus 4.5)`));
+    console.log(`  ${import_picocolors.default.green("Gain:")} Massive scale. You are a systems orchestrator.`);
+    console.log(`  ${import_picocolors.default.red("Lose:")} Architectural intimacy. You become a reviewer.`);
+    console.log(import_picocolors.default.cyan(`
+■ Next 5-10 Years (The 1M+ LOC Crisis)`));
+    console.log(`  When an agent introduces a fatal state bug in a monolithic architecture, human reviewers will lack the muscle memory to debug it. Outlier measures this exact sovereignty erosion.
 `);
-    console.log(import_picocolors.default.dim(" **********************************************************"));
+  } else if (action === "knowledge") {
     console.log(`
- ${import_picocolors.default.italic("patterns emerge in the commit history,")}`);
-    console.log(` ${import_picocolors.default.italic("code becomes commoditized by algorithms.")}`);
-    console.log(` ${import_picocolors.default.italic("human mastery is the only true moat.")}
+` + import_picocolors.default.bold(import_picocolors.default.bgBlue(" CORE LITERATURE & REFERENCES ")) + `
+`);
+    console.log(`1. ${import_picocolors.default.cyan("METR (Measuring AI Ability)")} - Evaluating AI on long-horizon software tasks.`);
+    console.log(`2. ${import_picocolors.default.cyan('The "NPC" vs "High-Agency" Paradigm')} - Remaining sovereign in a room full of agents.`);
+    console.log(`3. ${import_picocolors.default.cyan("Proof of Human Mastery")} - The cryptoeconomic necessity of proving human architectural understanding.`);
+    console.log(`
+Read the full academic foundation at: ${import_picocolors.default.underline("https://github.com/rosh100yx/outlier")}
 `);
-    console.log(import_picocolors.default.dim(` **********************************************************
-`));
-    console.log("                 Outlier Governance Engine");
-    console.log(import_picocolors.default.bold(`
-                   ***AUDIT COMPLETE***`));
-    console.log(import_picocolors.default.bold(`                   ***STAY VIGILANT***
-`));
   }
+  outro("Local telemetry run completed. No data left your machine.");
   console.log(import_picocolors.default.dim(`└ Share your audit: https://x.com/intent/tweet?text=${encodeURIComponent(`I just audited my codebase for AI reliance and deskilling risk. What does your repo score?
 
-\uD83D\uDCCF npx @rosh100yx/outlier`)}`));
-  console.log(import_picocolors.default.dim(`└ Have thoughts on AI deskilling? Tell us: `) + import_picocolors.default.cyan(`npx @rosh100yx/outlier confessional`));
-  console.log(import_picocolors.default.dim(`└ Keep your local policies updated: `) + import_picocolors.default.cyan(`npx @rosh100yx/outlier@latest`));
+\uD83D\uDCCF #Outlier`)}`));
+  if (action === "status") {
+    console.log(import_picocolors.default.dim(`└ Have thoughts on AI deskilling? Tell us: `) + import_picocolors.default.cyan(`outlier participate`));
+    console.log(import_picocolors.default.dim(`└ Keep your local policies updated: `) + import_picocolors.default.cyan(`outlier update`));
+  }
 }
 main().catch(console.error);

package/bin/postinstall.js

@@ -0,0 +1,17 @@
+#!/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`;
+
+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')}        Print your Thermal Audit Receipt`);
+console.log(`  ${cyan('outlier impact')}        See the compounding horizon of AI Deskilling (What you lose/gain)`);
+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(`  ${cyan('outlier help')}          See all available commands`);
+console.log(dim('────────────────────────────────────────────────────────────\n'));

package/package.json

@@ -1,19 +1,21 @@
 {
   "name": "@rosh100yx/outlier",
-  "version": "0.4.2",
+  "version": "0.4.10",
   "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"
   },
   "files": [
     "bin/outlier.js",
+    "bin/postinstall.js",
     "src",
     "data"
   ],
   "scripts": {
     "build": "bun build ./src/cli.ts --target=node --outfile bin/outlier.js",
     "test": "bun test",
-    "start": "bun run src/cli.ts"
+    "start": "bun run src/cli.ts",
+    "postinstall": "node bin/postinstall.js"
   },
   "type": "module",
   "private": false,

package/src/cli.ts

@@ -79,7 +79,8 @@ The results will assign you a "vibe" and evaluate if you are at risk of deskilli
 async function main() {
   console.clear();
   console.log(pc.cyan(ASCII_LOGO));
-  console.log(pc.dim('  Outlier v0.4.1 · AI Code Reliance & Telemetry Engine\n'));
+  const pkg = require('../package.json');
+  console.log(pc.dim(`  Outlier v${pkg.version} · AI Code Reliance & Telemetry Engine\n`));
   
   let action = process.argv[2] as any;
   
@@ -90,7 +91,9 @@ async function main() {
     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 confessional')} Submit qualitative feedback or feature requests`);
+    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('\n' + pc.dim('Run without arguments to start the interactive wizard.'));
     process.exit(0);
   }
@@ -113,7 +116,9 @@ async function main() {
           { value: 'authorship', label: 'Code Durability', hint: 'Scan git history for AI Code Reliance & Hallucination Risk' },
           { value: 'carbon', label: 'Cache Bloat', hint: 'Scan local logs for context waste & token costs' },
           { value: 'policy', label: 'Policy Profiles', hint: 'Set Personal, Team, or Enterprise guardrails in CI' },
-          { value: 'confessional', label: 'Confessional', hint: 'Tell us how AI is really affecting your job (Feature Requests)' }
+          { value: 'impact', label: 'Impact Horizon', hint: 'What do you lose and gain in the next 5-10 years?' },
+          { value: 'knowledge', label: 'Literature Base', hint: 'Explore references and the core academic foundation' },
+          { value: 'participate', label: 'Participate', hint: 'Contribute to the literature on AI deskilling' }
         ],
       });
 
@@ -282,6 +287,79 @@ ${costIcon}${pc.dim('[3] Tokenomics & Cost')} ${pc.magenta('▰▰▰▰▰▰
 ${pc.bold('Governance:')} ${ruleFailures > 0 ? pc.red(`${failIcon} ${ruleFailures + 1} policy failures`) : pc.green(`${passIcon} All clear`)}`,
           `${pc.bold('[outlier]')} ${5 - (ruleFailures+1)}/5 policies • ${authWarning || pc.green(`${passIcon} safe surface`)} • ${co2Str}`
         );
+
+        const timestamp = new Date().toISOString().split('T')[0];
+        const isDanger = gitStats && gitStats.ratio > 0.7;
+        const verdictZone = isDanger ? pc.red('DANGER ZONE') : pc.green('SAFE / SOVEREIGN');
+        const verdictText = isDanger 
+          ? `You are transitioning from 'Creator' to 'Reviewer'.\n   At this trajectory, you risk losing architectural \n   muscle memory on this codebase within 6 months.` 
+          : `You are maintaining strong architectural intimacy.\n   Your human judgement remains the primary driver\n   of logic in this system.`;
+          
+        const isInefficient = parseFloat(cachePct) > 40;
+        const cacheVerdict = isInefficient ? pc.yellow('INEFFICIENT') : pc.green('EFFICIENT');
+        const cacheText = isInefficient 
+          ? `You are burning paid API tokens and excess compute\n   on files the agent isn't even touching.` 
+          : `Your token usage and human judgment are tightly\n   coupled. High signal-to-noise ratio.`;
+          
+        const policyStatus = ruleFailures > 0 ? pc.red('BLOCKED 🛑 (Threshold Exceeded)') : pc.green('PASS ✅ (Within Threshold)');
+        const policyAction = ruleFailures > 0 ? 'Triggering Mandatory Mentoring Scenario.' : 'No intervention required.';
+
+        const totalTokensStr = carbon ? (carbon.totalTokens / 1000).toFixed(1) + 'k' : '0';
+        const humanSov = gitStats ? ((1 - gitStats.ratio) * 100).toFixed(1) + '%' : '100%';
+        const authorshipStr = authPct + (isDanger ? pc.red(' (High Reliance)') : pc.green(' (Healthy)'));
+
+        const getProgressBar = (pct: number, length = 10) => {
+          const filled = Math.max(0, Math.min(length, Math.round((pct / 100) * length)));
+          return '▰'.repeat(filled) + '▱'.repeat(length - filled);
+        };
+        
+        const aiPctVal = gitStats ? gitStats.ratio * 100 : 0;
+        const aiBar = pc.yellow(getProgressBar(aiPctVal));
+        const humanBar = pc.cyan(getProgressBar(100 - aiPctVal));
+        const cacheBar = pc.magenta(getProgressBar(parseFloat(cachePct) || 0));
+
+        if (!isStrict) {
+            const dateStr = new Date().toLocaleDateString('en-US', { month: 'short', day: '2-digit', year: 'numeric' }).toUpperCase();
+            const timeStr = new Date().toLocaleTimeString('en-US', { hour12: false });
+            const repoName = process.cwd().split('/').pop() || 'Unknown';
+            
+            console.log(`
+ ${pc.dim('┌────────────────────────────────────────────────────────')}
+ ${pc.dim('│')} ${pc.cyan('█▀█ █░█ ▀█▀ █░░ █ █▀▀ █▀█')}  ${pc.bold(':: THERMAL AUDIT RECEIPT')}
+ ${pc.dim('│')} ${pc.cyan('█▄█ █▄█ ░█░ █▄▄ █ ██▄ █▀▄')}  ${pc.dim(`:: TIMESTAMP: ${dateStr}`)}
+ ${pc.dim('├────────────────────────────────────────────────────────')}
+ ${pc.dim('│')} ${pc.bold(pc.bgBlue(' [ COGNITIVE BUDGET ] '))}
+ ${pc.dim('│')} AI Authorship     ................. ${aiBar} ${authorshipStr}
+ ${pc.dim('│')} Human Sovereignty ................. ${humanBar} ${humanSov}
+ ${pc.dim('│')}
+ ${pc.dim('│')} ↳ Verdict: ${verdictZone}
+ ${pc.dim('│')}   ${verdictText.split('\n').join('\n ' + pc.dim('│') + ' ')}
+ ${pc.dim('├────────────────────────────────────────────────────────')}
+ ${pc.dim('│')} ${pc.bold(pc.bgMagenta(' [ FINANCIAL & COMPUTE TOLL ] '))}
+ ${pc.dim('│')} Tokens Burnt      ................. ${totalTokensStr} vs Human Judgment
+ ${pc.dim('│')} Cache Bloat       ................. ${cacheBar} ${cachePct}% (Unmodified context)
+ ${pc.dim('│')} Regional Grid     ................. ${regionStr}
+ ${pc.dim('│')}
+ ${pc.dim('│')} ↳ Verdict: ${cacheVerdict}
+ ${pc.dim('│')}   ${cacheText.split('\n').join('\n ' + pc.dim('│') + ' ')}
+ ${pc.dim('├────────────────────────────────────────────────────────')}
+ ${pc.dim('│')} ${pc.bold(pc.bgYellow(pc.black(' [ POLICY ENFORCEMENT ] ')))}
+ ${pc.dim('│')} Status .................................. ${policyStatus}
+ ${pc.dim('│')} Action .................................. ${policyAction}
+ ${pc.dim('├────────────────────────────────────────────────────────')}
+ ${pc.dim('│')}
+ ${pc.dim('│')}  ${pc.italic(pc.dim('patterns emerge in the commit history,'))}
+ ${pc.dim('│')}  ${pc.italic(pc.dim('code becomes commoditized by algorithms.'))}
+ ${pc.dim('│')}  ${pc.italic(pc.dim('human mastery is the only true moat.'))}
+ ${pc.dim('│')}
+ ${pc.dim('│')}                   ${pc.bold(pc.cyan('***STAY VIGILANT***'))}
+ ${pc.dim('└────────────────────────────────────────────────────────')}`);
+        } else {
+            note(
+              `status: ${authPct} AI Reliance | ${cachePct}% Cache Bloat | ${co2Str}`,
+              `${pc.bold('[outlier]')} CI/CD Audit`
+            );
+        }
     } catch (e: any) {
       s.stop('Audit failed');
       console.error(pc.red(e.message));
@@ -410,8 +488,8 @@ Artifact:     ${pc.cyan(reportPath)}`,
         'Regulatory Compliance'
       );
     }
-  } else if (action === 'confessional') {
-    s.start('Connecting to the human element...');
+  } else if (action === 'participate') {
+    s.start('Connecting to the Outlier research project...');
     await new Promise(resolve => setTimeout(resolve, 600));
     s.stop('Secure connection established.');
 
@@ -424,7 +502,7 @@ Artifact:     ${pc.cyan(reportPath)}`,
       ]
     });
 
-    if (isCancel(q1)) { cancel('Confession aborted.'); process.exit(0); }
+    if (isCancel(q1)) { cancel('Survey aborted.'); process.exit(0); }
 
     const q2 = await select({
       message: pc.cyan('Do you feel you are losing your deep architectural mastery? (Deskilling)'),
@@ -435,77 +513,69 @@ Artifact:     ${pc.cyan(reportPath)}`,
       ]
     });
     
-    if (isCancel(q2)) { cancel('Confession aborted.'); process.exit(0); }
+    if (isCancel(q2)) { cancel('Survey aborted.'); process.exit(0); }
 
     const feedback = await text({
       message: pc.cyan('In your own words, what is AI actually doing to your codebase or your job?\n(Note: This will draft a public GitHub issue)'),
       placeholder: 'Honestly, I just let the agent write the regex...',
       validate(value) {
-        if (!value || value.length === 0) return `C'mon, confess something!`;
+        if (!value || value.length === 0) return `C'mon, say something!`;
       },
     });
 
     if (isCancel(feedback)) {
-      cancel('Confession aborted.');
+      cancel('Survey aborted.');
       process.exit(0);
     }
 
     note(
-      `${pc.italic(`"${feedback}"`)}\n\nYour confession is safe with us. But if you want to make it official (and help us build what you need for the literature), we've generated a secure transmission link for you.`,
-      'The Confessional'
+      `${pc.italic(`"${feedback}"`)}\n\nYour input is invaluable. To make it official and contribute to the literature, we've generated a secure transmission link for you.`,
+      'Outlier Research'
     );
 
     const surveyData = `**Engineering Reality:** ${q1}\n**Deskilling Impact:** ${q2}\n**Thoughts:**\n${feedback}`;
 
-    const url = `https://github.com/rosh100yx/outlier/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.md&title=%5BConfessional%5D+Feedback&body=${encodeURIComponent("Drop a screenshot of your Thermal Receipt here! \n\n" + surveyData)}`;
+    const url = `https://github.com/rosh100yx/outlier/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.md&title=%5BOutlier+Research%5D+Feedback&body=${encodeURIComponent("Drop a screenshot of your Thermal Receipt here! \n\n" + surveyData)}`;
     console.log(`\n${pc.bold('Submit here (and drop your screenshot!):')} ${pc.underline(pc.cyan(url))}\n`);
+  } else if (action === 'impact') {
+    console.log('\n' + pc.bold(pc.bgMagenta(' THE COMPOUNDING HORIZON OF DESKILLING ')) + '\n');
+    console.log(pc.bold('What Do We Lose and Gain?'));
+    console.log(pc.cyan('■ Today (The 5-minute task)'));
+    console.log(`  ${pc.green('Gain:')} Velocity. AI scaffolds your components.`);
+    console.log(`  ${pc.red('Lose:')} Syntax recall. Memory of the low-level pipes.`);
+    console.log(pc.cyan('\n■ Tomorrow (The 5-hour task - e.g. Claude Opus 4.5)'));
+    console.log(`  ${pc.green('Gain:')} Massive scale. You are a systems orchestrator.`);
+    console.log(`  ${pc.red('Lose:')} Architectural intimacy. You become a reviewer.`);
+    console.log(pc.cyan('\n■ Next 5-10 Years (The 1M+ LOC Crisis)'));
+    console.log(`  When an agent introduces a fatal state bug in a monolithic architecture, human reviewers will lack the muscle memory to debug it. Outlier measures this exact sovereignty erosion.\n`);
+  } else if (action === 'knowledge') {
+    console.log('\n' + pc.bold(pc.bgBlue(' CORE LITERATURE & REFERENCES ')) + '\n');
+    console.log(`1. ${pc.cyan('METR (Measuring AI Ability)')} - Evaluating AI on long-horizon software tasks.`);
+    console.log(`2. ${pc.cyan('The "NPC" vs "High-Agency" Paradigm')} - Remaining sovereign in a room full of agents.`);
+    console.log(`3. ${pc.cyan('Proof of Human Mastery')} - The cryptoeconomic necessity of proving human architectural understanding.`);
+    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.');
 
-  // Artifact Level Storytelling: Dither Garden style thermal receipt
-  if (action === 'status' || action === 'authorship' || action === 'carbon') {
-    const d = new Date();
-    const dateStr = d.toLocaleDateString('en-US', { month: 'short', day: '2-digit', year: 'numeric' }).toUpperCase();
-    const timeStr = d.toLocaleTimeString('en-US', { hour12: false });
-    
-    let repoName = process.cwd().split('/').pop() || 'Unknown';
-    
-    console.log(`\n${pc.dim('-------------------------')} ${pc.bold('AUDIT RECEIPT')} ${pc.dim('-------------------------')}`);
-    console.log(`\n Project                                      ${pc.bold(repoName.padEnd(16).substring(0,16))}`);
-    console.log(` Timestamp                                  ${pc.dim(`${dateStr} ${timeStr}`)}\n`);
-    
-    console.log(` 01x Authorship Policy                      ${process.argv.includes('--strict') ? 'Strict Mode' : 'Vibe Check'}`);
-    console.log(` 02x AI Reliance Risk                       ${action === 'carbon' ? 'N/A' : 'Assessed'}`);
-    console.log(` 03x Cache Bloat Tokens                     ${action === 'authorship' ? 'N/A' : 'Audited'}`);
-    console.log(` 04x Regional Grid Check                    ${action === 'authorship' ? 'N/A' : 'Completed'}\n`);
-    
-    console.log(pc.dim(' **********************************************************'));
-    console.log(`\n ${pc.italic('patterns emerge in the commit history,')}`);
-    console.log(` ${pc.italic('code becomes commoditized by algorithms.')}`);
-    console.log(` ${pc.italic('human mastery is the only true moat.')}\n`);
-    console.log(pc.dim(' **********************************************************\n'));
-    
-    console.log('                 Outlier Governance Engine');
-    console.log(pc.bold('\n                   ***AUDIT COMPLETE***'));
-    console.log(pc.bold('                   ***STAY VIGILANT***\n'));
-  }
+  // (Old artifact storytelling block removed to unify receipt UX)
 
   console.log(
     pc.dim(
       `└ Share your audit: https://x.com/intent/tweet?text=${encodeURIComponent(
-        'I just audited my codebase for AI reliance and deskilling risk. What does your repo score?\n\n📏 npx @rosh100yx/outlier'
+        'I just audited my codebase for AI reliance and deskilling risk. What does your repo score?\n\n📏 #Outlier'
       )}`
     )
   );
-  
-  console.log(
-    pc.dim(`└ Have thoughts on AI deskilling? Tell us: `) + pc.cyan(`npx @rosh100yx/outlier confessional`)
-  );
 
-  console.log(
-    pc.dim(`└ Keep your local policies updated: `) + pc.cyan(`npx @rosh100yx/outlier@latest`)
-  );
+  if (action === 'status') {
+    console.log(
+      pc.dim(`└ Have thoughts on AI deskilling? Tell us: `) + pc.cyan(`outlier participate`)
+    );
+    console.log(
+      pc.dim(`└ Keep your local policies updated: `) + pc.cyan(`outlier update`)
+    );
+  }
 }
 
 main().catch(console.error);