@rosh100yx/outlier 0.3.1 → 0.4.1

package/README.md

@@ -1,8 +1,12 @@
 <div align="center">
-  <img src="assets/cover.jpg" alt="Outlier Cover" width="100%" />
+  <img src="https://raw.githubusercontent.com/rosh100yx/outlier/main/assets/cover.jpg" alt="Outlier Cover" width="100%" />
   <h1>outlier</h1>
   <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" />
@@ -17,7 +21,7 @@
   </p>
 
   <br/>
-  <img src="assets/cli-demo.png" alt="Outlier CLI Demo" width="800" />
+  <img src="https://raw.githubusercontent.com/rosh100yx/outlier/main/assets/cli-demo.png" alt="Outlier CLI Demo" width="800" />
   <br/>
 </div>
 
@@ -32,7 +36,7 @@
 > *"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="assets/codecore.gif" alt="Codecore Aesthetic" width="300" />
+  <img src="https://raw.githubusercontent.com/rosh100yx/outlier/main/assets/codecore.gif" alt="Codecore Aesthetic" width="300" />
 </div>
 
 ## How It Works
@@ -63,10 +67,13 @@
 ## Commands
 | Command | Purpose |
 |---------|---------|
-| `outlier audit` | Run the standard telemetry dashboard (Cats + Vibes + Metrics) |
-| `outlier audit --strict` | Run the dashboard without the Cats/Vibes (Enterprise Dry Mode) |
-| `outlier policy` | Interactively select and install the Git Pre-Commit Hook (Bouncer) |
-| `outlier capabilities` | Audit your workspace for active MCP servers and Open Session Skills |
+| `outlier` | Start the interactive Onboarding Wizard (Recommended for first-timers) |
+| `outlier --help` | View the CLI help menu and all available commands |
+| `outlier status` | Run the full AI reliance & capability audit (Generates the Thermal Receipt) |
+| `outlier authorship` | Scan git history for AI co-authorship ratio and Hallucination Risk |
+| `outlier carbon` | Scan local logs for context waste & token costs |
+| `outlier policy` | Configure Personal, Team, or Enterprise guardrails in CI |
+| `outlier confessional` | Submit qualitative feedback or feature requests directly from the terminal |
 
 ## Quickstart: Your First Audit
 
@@ -100,7 +107,7 @@
 ## FAQ
 
 **Does this send my code or prompts to the cloud?**  
-No. `outlier` is a zero-trust, local-first engine. It parses `git log` and local JSONL token logs. Your code and token usage never leave your machine.
+**Absolutely not.** `outlier` is built on a strict **Zero-Trust, Local-First Architecture**. It runs native parsing commands against your `.git/` history and your local `~/.claude/` session logs. It never calls an API, it never extracts your proprietary data, and it never phones home. Your research, your code, and your prompts stay 100% on your machine. We believe in open-source integrity.
 
 **Do I need to be using a specific IDE?**  
 `outlier` is IDE-agnostic. It works by parsing standard `Co-Authored-By` Git trailers, meaning it supports Claude Code, Cursor, Aider, and manual generation.

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@rosh100yx/outlier",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "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"
+    "outlier": "bin/outlier"
   },
   "files": [
-    "bin/outlier.js",
+    "bin/outlier",
     "src",
     "data"
   ],
@@ -19,6 +19,10 @@
   "private": false,
   "author": "Roshan Abraham",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rosh100yx/outlier.git"
+  },
   "keywords": [
     "ai",
     "governance",
@@ -42,7 +46,6 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.6.0",
-    "commander": "^15.0.0",
     "picocolors": "^1.1.1"
   }
 }

package/src/cli.ts

@@ -1,11 +1,12 @@
 #!/usr/bin/env bun
-import { intro, outro, select, spinner, isCancel, cancel, note } from '@clack/prompts';
+import { intro, outro, select, spinner, isCancel, cancel, note, text } from '@clack/prompts';
 import pc from 'picocolors';
 import { getAuthorshipStats } from './git';
 import { getCarbonStats } from './carbon';
 import { getCapabilitiesStats } from './capabilities';
 import { writeFileSync, chmodSync, existsSync } from 'fs';
 import { join } from 'path';
+import { execSync } from 'child_process';
 
 const ASCII_LOGO = `
    ____  _   _ _____ _     ___ _____ ____  
@@ -78,10 +79,22 @@ 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.3.1 · AI Code Reliance & Telemetry Engine\n'));
+  console.log(pc.dim('  Outlier v0.4.1 · AI Code Reliance & Telemetry Engine\n'));
   
   let action = process.argv[2] as any;
   
+  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 confessional')} Submit qualitative feedback or feature requests`);
+    console.log('\n' + pc.dim('Run without arguments to start the interactive wizard.'));
+    process.exit(0);
+  }
+
   const configPath = join(os.homedir(), '.outlier_config');
   if (!existsSync(configPath) && !action) {
     await runOnboarding();
@@ -99,7 +112,8 @@ async function main() {
           { value: 'capabilities', label: 'Capabilities Map', hint: 'Audit active MCPs, skills, and orchestrations' },
           { 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: '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)' }
         ],
       });
 
@@ -137,15 +151,13 @@ Ratio: ~31x carbon penalty on coal-heavy grid`,
       s.stop('Audit failed');
       console.error(pc.red(e.message));
     }
-  } else if (action === 'authorship' || action === 'status') {
-    s.start('Scanning local git history and agent logs...');
-    
+  } else if (action === 'authorship') {
+    s.start('Scanning local git history...');
     try {
       const gitStats = await getAuthorshipStats().catch(() => null);
-      const carbon = await getCarbonStats().catch(() => null);
       s.stop('Audit complete');
       
-      if (action === 'authorship' && gitStats) {
+      if (gitStats) {
         const pct = (gitStats.ratio * 100).toFixed(1);
         const nmPct = (gitStats.ratioNoMerges * 100).toFixed(1);
         
@@ -169,14 +181,53 @@ AI Co-Authored:     ${gitStats.aiNoMerges}
 Conservative Floor: ${color(nmPct + '%')}`,
             'Git Authorship Breakdown'
           );
-      } else if (action === 'status') {
-        const isStrict = process.argv.includes('--strict');
-        s.start('Running outlier telemetry audit...');
-        const carbon = await getCarbonStats().catch(() => null);
-        const gitStats = await getAuthorshipStats().catch(() => null);
-        const capabilities = await getCapabilitiesStats().catch(() => null);
-        s.stop('Audit complete');
-        
+      }
+    } catch (e: any) {
+      s.stop('Audit failed');
+      console.error(pc.red(e.message));
+    }
+  } else if (action === 'status') {
+    const isStrict = process.argv.includes('--strict');
+    
+    let gitStats: any = null;
+    let carbon: any = null;
+    let capabilities: any = null;
+
+    if (!isStrict) {
+      s.start('[SYSTEM] Booting local-first sandbox...');
+      await new Promise(r => setTimeout(r, 800));
+      s.message(`↳ Guarantee: No API calls. Your code and logs never leave this machine.`);
+      await new Promise(r => setTimeout(r, 1200));
+      
+      s.message('[GIT] Scanning your commit history...');
+      gitStats = await getAuthorshipStats().catch(() => null);
+      await new Promise(r => setTimeout(r, 600));
+      s.message(`↳ Check: Are you writing the code, or just reviewing what the AI wrote?`);
+      await new Promise(r => setTimeout(r, 1200));
+      
+      s.message('[TOKENS] Parsing local AI logs (~/.claude/)...');
+      carbon = await getCarbonStats().catch(() => null);
+      await new Promise(r => setTimeout(r, 600));
+      s.message(`↳ Check: How much API waste is your workflow generating locally?`);
+      await new Promise(r => setTimeout(r, 1200));
+      
+      s.message('[ANALYSIS] Calculating your mastery score...');
+      capabilities = await getCapabilitiesStats().catch(() => null);
+      await new Promise(r => setTimeout(r, 600));
+      s.message(`↳ Warning: Heavy AI use creates the 'Illusion of Competence'. Don't lose your edge.`);
+      await new Promise(r => setTimeout(r, 1200));
+      
+      s.message('[PRINT] Generating Thermal Receipt...');
+      await new Promise(r => setTimeout(r, 600));
+    } else {
+      s.start('Running outlier telemetry audit...');
+      gitStats = await getAuthorshipStats().catch(() => null);
+      carbon = await getCarbonStats().catch(() => null);
+      capabilities = await getCapabilitiesStats().catch(() => null);
+    }
+    s.stop('Audit complete');
+    
+    try {
         let authPct = '0%';
         let ruleFailures = 0;
         let authWarning = '';
@@ -231,7 +282,6 @@ ${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}`
         );
-      }
     } catch (e: any) {
       s.stop('Audit failed');
       console.error(pc.red(e.message));
@@ -304,8 +354,8 @@ ${caps.skills.length > 5 ? pc.red('⚠ High Surface Area: Ensure strict authorsh
 
       const isStrict = process.argv.includes('--strict');
       const bouncerMsg = isStrict 
-        ? `echo "❌ outlier policy violation: AI authorship ($CURRENT_RATIO%) exceeds threshold ($MAX_RATIO%)"`
-        : `echo "😾 ✋ The Bouncer says no: Your code is $CURRENT_RATIO% AI-generated."\n    echo "A human must review this before it enters the club (main branch)."`;
+        ? `echo "⚠️  outlier policy warning: AI authorship ($CURRENT_RATIO%) exceeds threshold ($MAX_RATIO%)"`
+        : `echo "🛡️  Outlier Bouncer: Repository AI-generation ($CURRENT_RATIO%) exceeds your defined mastery threshold ($MAX_RATIO%)."\n    echo "Take a moment to review your recent architectural decisions. Ensure you still understand the system."`;
 
       const hookPath = join(gitDir, 'hooks', 'pre-commit');
       if (existsSync(hookPath)) {
@@ -323,10 +373,11 @@ if [ "$TOTAL" -eq 0 ]; then exit 0; fi
 CURRENT_RATIO=$(awk "BEGIN {print ($AI / $TOTAL) * 100}")
 MAX_RATIO=${maxAuthorship}
 
-OVER_LIMIT=$(awk "BEGIN {if ($CURRENT_RATIO > $MAX_RATIO) print 1; else print 0}")
+OVER_LIMIT=$(awk "BEGIN {print ($CURRENT_RATIO > $MAX_RATIO) ? 1 : 0}")
 if [ "$OVER_LIMIT" -eq 1 ]; then
     ${bouncerMsg}
-    exit 1
+    # Warn instead of hard-blocking the commit, protecting human iterations
+    exit 0
 fi
 echo "✅ Governance Policy OK"
 `;
@@ -348,7 +399,7 @@ Enforcement:  ${pc.cyan('Local pre-commit hook installed (backup created)')}`,
       await new Promise(resolve => setTimeout(resolve, 1200));
       
       const reportPath = join(process.cwd(), 'outlier-audit-report.jsonl');
-      writeFileSync(reportPath, JSON.stringify({ timestamp: new Date().toISOString(), status: 'COMPLIANT', policy: 'Decree 142', humanOversight: true }) + '\\n');
+      writeFileSync(reportPath, JSON.stringify({ timestamp: new Date().toISOString(), status: 'PREVIEW', policy: 'Decree 142', simulatedOversight: true }) + '\n');
       s.stop('Audit Generated');
 
       note(
@@ -359,6 +410,55 @@ Artifact:     ${pc.cyan(reportPath)}`,
         'Regulatory Compliance'
       );
     }
+  } else if (action === 'confessional') {
+    s.start('Connecting to the human element...');
+    await new Promise(resolve => setTimeout(resolve, 600));
+    s.stop('Secure connection established.');
+
+    const q1 = await select({
+      message: pc.cyan('What is your current engineering reality today?'),
+      options: [
+        { value: 'artisan', label: 'Solo Artisan (I write 90%+ of the code myself)' },
+        { value: 'manager', label: 'AI Manager (I prompt, the agents write)' },
+        { value: 'reviewer', label: 'Full-time Reviewer (I spend my days reviewing agent PRs)' }
+      ]
+    });
+
+    if (isCancel(q1)) { cancel('Confession aborted.'); process.exit(0); }
+
+    const q2 = await select({
+      message: pc.cyan('Do you feel you are losing your deep architectural mastery? (Deskilling)'),
+      options: [
+        { value: 'yes_heavy', label: 'Yes, heavily. I forget how my own systems work.' },
+        { value: 'yes_slight', label: 'Slightly. I rely on the AI to fix its own bugs.' },
+        { value: 'no', label: 'No. I maintain strict oversight and mastery.' }
+      ]
+    });
+    
+    if (isCancel(q2)) { cancel('Confession 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 (isCancel(feedback)) {
+      cancel('Confession 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'
+    );
+
+    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)}`;
+    console.log(`\n${pc.bold('Submit here (and drop your screenshot!):')} ${pc.underline(pc.cyan(url))}\n`);
   }
 
   outro('Local telemetry run completed. No data left your machine.');
@@ -398,6 +498,14 @@ Artifact:     ${pc.cyan(reportPath)}`,
       )}`
     )
   );
+  
+  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`)
+  );
 }
 
 main().catch(console.error);

package/bin/outlier.js

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-import { spawnSync } from 'child_process';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const cliPath = path.join(__dirname, '../src/cli.ts');
-const result = spawnSync('bun', ['run', cliPath, ...process.argv.slice(2)], {
-  stdio: 'inherit'
-});
-
-process.exit(result.status || 0);