@rosh100yx/outlier 0.3.1 → 0.4.0

package/README.md

@@ -3,6 +3,10 @@
   <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" />
@@ -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.0",
   "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"
   ],
@@ -42,7 +42,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.0 · 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,37 @@ 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 feedback = await text({
+      message: pc.cyan('What is AI actually doing to your codebase? Are you a 10x dev or a 10x reviewer now?\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), we've generated a secure transmission link for you.`,
+      'The Confessional'
+    );
+
+    const url = `https://github.com/rosh100yx/outlier/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.md&title=%5BConfessional%5D+Feedback&body=${encodeURIComponent(feedback.toString())}`;
+    console.log(`\n${pc.bold('Submit here:')} ${pc.underline(pc.cyan(url))}\n`);
+    
+    try {
+      if (process.platform === 'darwin') {
+        execSync(`open "${url}"`);
+      }
+    } catch(e) {}
   }
 
   outro('Local telemetry run completed. No data left your machine.');

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);