@rosh100yx/outlier 0.4.2 → 0.4.4

package/README.md

@@ -4,36 +4,37 @@
   <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>
+</div>
 
-  <br/>
-  <img src="https://raw.githubusercontent.com/rosh100yx/outlier/main/assets/cli-demo.png" alt="Outlier CLI Demo" width="800" />
-  <br/>
+## The Compounding Value of Outlier (Why This Matters)
+Software engineering is undergoing a catastrophic shift in skill acquisition. If you only look at today, AI saves you 30 minutes of writing regex. But if you look at the **compounding horizon of the next 5-10 years**, the value exchange flips.
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/rosh100yx/outlier/main/assets/metr-long-tasks.png" alt="METR Graph" width="800" />
+  <p><i>Source: METR (Measuring AI Ability to Complete Long Tasks)</i></p>
 </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. 
+### What Do We Lose and Gain?
+- **Today (The 5-minute task):** You use AI to scaffold a component. You **gain** velocity. You **lose** syntax recall. 
+- **Tomorrow (The 5-hour task):** Models like Claude Opus 4.5 will autonomously resolve multi-file architectural tickets (as proven by the METR graph). You **gain** massive scale and leverage. You **lose** granular intimacy with your own system architecture. You transition from a *Creator* to a *Reviewer*.
+- **The Next 5-10 Years:** Unchecked AI reliance leads to **Deskilling**. When an agent introduces a fatal state bug in a 1M+ LOC codebase, the human reviewers will lack the muscle memory and "systems thinking" required to debug it. 
 
-**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.
+### How The Paper and Project Complement Each Other
+`outlier` is the technical circuit breaker that forces developers to remain High-Agency. The **Paper** maps the trajectory of global skill atrophy and the geographic carbon tax of AI. The **Project (CLI)** is the empirical instrument that gathers this data safely, proving the literature while simultaneously protecting the developer's sovereignty. 
 
-> *"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.*
+We measure the exact cost of AI for humans—not just in API tokens, 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" />

package/bin/outlier.js

@@ -1943,7 +1943,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 +1966,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)) {
@@ -2217,8 +2221,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 +2234,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 +2246,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,25 +2255,51 @@ 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))}
+`);
+  } else if (action === "impact") {
+    console.log(`
+` + import_picocolors.default.bold(import_picocolors.default.bgMagenta(" THE COMPOUNDING HORIZON OF DESKILLING ")) + `
+`);
+    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.
+`);
+  } else if (action === "knowledge") {
+    console.log(`
+` + 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")}
 `);
   }
   outro("Local telemetry run completed. No data left your machine.");
@@ -2305,8 +2335,10 @@ ${import_picocolors.default.dim("-------------------------")} ${import_picocolor
   }
   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.4",
   "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

@@ -90,7 +90,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 +115,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' }
         ],
       });
 
@@ -410,8 +414,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 +428,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,30 +439,47 @@ 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.');
@@ -494,18 +515,19 @@ Artifact:     ${pc.cyan(reportPath)}`,
   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);