ft-scout 1.0.0

package/.ft/context.json

@@ -0,0 +1,14 @@
+{
+  "projectName": "FT-CLI",
+  "stack": "The FT-CLI project is a command-line interface tool built with Node.js, TypeScript, and various dependencies such as commander and dotenv, which suggests it handles tasks related to file management, git operations, and possibly AI-powered features via OpenAI. Its core stack includes TypeScript, JavaScript, and multiple libraries for interactive prompts and terminal output customization.",
+  "entryPoint": "bin/ft.js",
+  "painPoints": [
+    "Potential complexity in integrating multiple third-party libraries, lack of tests as indicated by the 'test' script in package.json"
+  ],
+  "readOrder": [
+    "package.json",
+    "bin/ft.js",
+    "tsconfig.json"
+  ],
+  "createdAt": "2026-07-30T07:56:23.435Z"
+}

package/README.md

@@ -0,0 +1,48 @@
+# ft-scout
+
+FrontTerrain — The Onboarding Co-Pilot for New Codebases.
+
+## Installation
+
+Install globally using npm:
+
+```bash
+npm install -g ft-scout
+```
+
+## Setup
+
+To use the AI-powered summary and onboarding features, you must provide your own API key for the GROQ platform. 
+
+Set the `GROQ_API_KEY` environment variable in your shell:
+
+**macOS / Linux:**
+```bash
+export GROQ_API_KEY="your-groq-api-key"
+```
+
+**Windows (PowerShell):**
+```powershell
+$env:GROQ_API_KEY="your-groq-api-key"
+```
+
+## Usage
+
+Once installed, you can use the `ft` or `ft-cli` commands.
+
+```bash
+# Initialize learning on a local repository
+ft init [repoUrl]
+
+# Print a brief, AI-powered onboarding summary
+ft brief
+
+# Show knowledge holders of a specific directory or file
+ft owners <path>
+
+# Show a code fragility map based on churn and hotfixes
+ft risky
+
+# Diagnose local setup, missing .env files, and runtime mismatches
+ft setup
+```

package/bin/ft.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('./src/index.js');

package/bin/src/commands/brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["brief.ts"],"names":[],"mappings":"AAKA,wBAAsB,WAAW,kBA6BhC"}

package/bin/src/commands/brief.js

@@ -0,0 +1,27 @@
+import { spinner, note } from '@clack/prompts';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+export async function handleBrief() {
+    const s = spinner();
+    s.start('Reading codebase structure and .ft metadata...');
+    const configPath = path.join(process.cwd(), '.ft', 'context.json');
+    if (!fs.existsSync(configPath)) {
+        s.stop(chalk.red('No local context found.'));
+        console.log('\nPlease run `ft init` first to index this repository.');
+        return;
+    }
+    const rawData = fs.readFileSync(configPath, 'utf-8');
+    const context = JSON.parse(rawData);
+    s.stop('Repository analysis complete.');
+    note(`Project: ${chalk.bold(context.projectName)}
+Primary Stack: ${chalk.yellow(context.stack)}
+Entry Point: ${chalk.cyan(context.entryPoint)}
+
+${chalk.bold('Known Pain Points:')}
+${context.painPoints.map((p) => `• ${p}`).join('\n')}
+
+${chalk.bold('Suggested Reading Order:')}
+${context.readOrder.map((r, idx) => `${idx + 1}. ${r}`).join('\n')}`, '💡 Onboarding Brief');
+}
+//# sourceMappingURL=brief.js.map

package/bin/src/commands/brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.js","sourceRoot":"","sources":["brief.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IACpB,CAAC,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAE1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAEnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEpC,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAExC,IAAI,CACF,YAAY,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;iBAC9B,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;eAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;;EAE3C,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC;EAChC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;EAE1D,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC;EACtC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAChF,qBAAqB,CACtB,CAAC;AACJ,CAAC"}

package/bin/src/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["init.ts"],"names":[],"mappings":"AAKA,wBAAsB,UAAU,CAAC,OAAO,EAAE,GAAG,iBAmB5C"}

package/bin/src/commands/init.js

@@ -0,0 +1,22 @@
+import fs from 'fs';
+import path from 'path';
+import { generateRepoSummary } from '../engine/llm.js';
+import { saveContext } from '../utils/config.js';
+export async function handleInit(repoUrl) {
+    const cwd = process.cwd();
+    const pkgPath = path.join(cwd, 'package.json');
+    const pkgContent = fs.existsSync(pkgPath) ? fs.readFileSync(pkgPath, 'utf-8') : '{}';
+    // Quick file scanner (excluding node_modules / git)
+    const filesList = fs.readdirSync(cwd).filter((f) => !['node_modules', '.git', 'dist'].includes(f));
+    // Get AI insight
+    const aiInsight = await generateRepoSummary(path.basename(cwd), filesList, pkgContent);
+    saveContext({
+        projectName: path.basename(cwd),
+        stack: aiInsight.summary,
+        entryPoint: aiInsight.entryPoint,
+        painPoints: aiInsight.painPoints,
+        readOrder: aiInsight.readOrder,
+        createdAt: new Date().toISOString(),
+    });
+}
+//# sourceMappingURL=init.js.map

package/bin/src/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAY;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAErF,oDAAoD;IACpD,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnG,iBAAiB;IACjB,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAEvF,WAAW,CAAC;QACV,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC/B,KAAK,EAAE,SAAS,CAAC,OAAO;QACxB,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;AACL,CAAC"}

package/bin/src/commands/owners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owners.d.ts","sourceRoot":"","sources":["owners.ts"],"names":[],"mappings":"AAAA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,iBAAI"}

package/bin/src/commands/owners.js

@@ -0,0 +1,2 @@
+export async function handleOwners(path) { }
+//# sourceMappingURL=owners.js.map

package/bin/src/commands/owners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owners.js","sourceRoot":"","sources":["owners.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,IAAG,CAAC"}

package/bin/src/commands/risky.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risky.d.ts","sourceRoot":"","sources":["risky.ts"],"names":[],"mappings":"AAWA,wBAAsB,WAAW,kBA6ChC"}

package/bin/src/commands/risky.js

@@ -0,0 +1,43 @@
+import { spinner, note } from '@clack/prompts';
+import chalk from 'chalk';
+import { simpleGit } from 'simple-git';
+export async function handleRisky() {
+    const s = spinner();
+    s.start('Analyzing git history & churn patterns...');
+    const git = simpleGit();
+    const log = await git.log({ maxCount: 200 }); // Scan last 200 commits
+    const fileStats = {};
+    for (const commit of log.all) {
+        const isHotfix = /fix|bug|hotfix|patch/i.test(commit.message);
+        // Get files changed in this commit
+        const diff = await git.show(['--name-only', '--oneline', commit.hash]);
+        const files = diff.split('\n').slice(1).filter(Boolean);
+        for (const file of files) {
+            if (!fileStats[file]) {
+                fileStats[file] = { total: 0, hotfixes: 0 };
+            }
+            fileStats[file].total += 1;
+            if (isHotfix)
+                fileStats[file].hotfixes += 1;
+        }
+    }
+    s.stop('Fragility analysis complete.');
+    // Sort by risk score
+    const results = Object.entries(fileStats)
+        .map(([file, stats]) => {
+        let riskLevel = 'LOW';
+        if (stats.hotfixes >= 3 || stats.total > 15)
+            riskLevel = 'HIGH';
+        else if (stats.hotfixes >= 1 || stats.total > 7)
+            riskLevel = 'MEDIUM';
+        return { file, churnCount: stats.total, hotfixes: stats.hotfixes, riskLevel };
+    })
+        .filter((r) => r.riskLevel !== 'LOW')
+        .sort((a, b) => b.hotfixes - a.hotfixes);
+    const formattedOutput = results.slice(0, 5).map((r) => {
+        const icon = r.riskLevel === 'HIGH' ? chalk.red('🔴 HIGH RISK') : chalk.yellow('🟡 MEDIUM RISK');
+        return `${icon} ${chalk.bold(r.file)}\n   └─ ${r.churnCount} commits, ${r.hotfixes} hotfixes detected`;
+    }).join('\n\n');
+    note(formattedOutput || chalk.green('No high-risk hotspots found!'), '🔥 Codebase Risk Map');
+}
+//# sourceMappingURL=risky.js.map

package/bin/src/commands/risky.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risky.js","sourceRoot":"","sources":["risky.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AASvD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IACpB,CAAC,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAErD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,wBAAwB;IAEtE,MAAM,SAAS,GAAwD,EAAE,CAAC;IAE1E,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE9D,mCAAmC;QACnC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAExD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC9C,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YAC3B,IAAI,QAAQ;gBAAE,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAEvC,qBAAqB;IACrB,MAAM,OAAO,GAAgB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SACnD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACrB,IAAI,SAAS,GAA8B,KAAK,CAAC;QACjD,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE;YAAE,SAAS,GAAG,MAAM,CAAC;aAC3D,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC;YAAE,SAAS,GAAG,QAAQ,CAAC;QAEtE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAChF,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE3C,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpD,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACjG,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,UAAU,aAAa,CAAC,CAAC,QAAQ,oBAAoB,CAAC;IACzG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC,KAAK,CAAC,8BAA8B,CAAC,EAAE,sBAAsB,CAAC,CAAC;AAC/F,CAAC"}

package/bin/src/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["setup.ts"],"names":[],"mappings":"AAKA,wBAAsB,WAAW,kBAmChC"}

package/bin/src/commands/setup.js

@@ -0,0 +1,35 @@
+import { spinner, note } from '@clack/prompts';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+export async function handleSetup() {
+    const s = spinner();
+    s.start('Diagnosing local runtime environment...');
+    const issues = [];
+    const passes = [];
+    // Check 1: .env vs .env.example
+    const cwd = process.cwd();
+    const hasEnv = fs.existsSync(path.join(cwd, '.env'));
+    const hasExample = fs.existsSync(path.join(cwd, '.env.example'));
+    if (!hasEnv && hasExample) {
+        issues.push(`Missing ${chalk.yellow('.env')} file! (Found .env.example)`);
+    }
+    else if (hasEnv) {
+        passes.push(`${chalk.green('✓')} Environment file .env present.`);
+    }
+    // Check 2: Node version check (.nvmrc or package.json engines)
+    const pkgPath = path.join(cwd, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        if (pkg.engines?.node) {
+            passes.push(`${chalk.green('✓')} Expected Node engine: ${pkg.engines.node} (Current: ${process.version})`);
+        }
+    }
+    s.stop('Setup diagnosis complete.');
+    const report = [
+        ...passes,
+        ...issues.map((i) => `${chalk.red('⚠️ ')} ${i}`),
+    ].join('\n');
+    note(report, '🛠️ Setup Doctor');
+}
+//# sourceMappingURL=setup.js.map

package/bin/src/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IACpB,CAAC,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,gCAAgC;IAChC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;IAEjE,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC;IAC5E,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IACpE,CAAC;IAED,+DAA+D;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,GAAG,CAAC,OAAO,CAAC,IAAI,cAAc,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC;IAED,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAEpC,MAAM,MAAM,GAAG;QACb,GAAG,MAAM;QACT,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;KACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACnC,CAAC"}

package/bin/src/engine/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["git.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAwB1E"}

package/bin/src/engine/git.js

@@ -0,0 +1,25 @@
+import { simpleGit } from 'simple-git';
+const git = simpleGit();
+export async function getFileOwners(filePath) {
+    const log = await git.log({ file: filePath });
+    const total = log.total;
+    if (total === 0)
+        return [];
+    const stats = {};
+    for (const commit of log.all) {
+        const author = commit.author_name;
+        if (!stats[author]) {
+            stats[author] = { count: 0, lastDate: commit.date };
+        }
+        stats[author].count += 1;
+    }
+    return Object.entries(stats)
+        .map(([author, data]) => ({
+        author,
+        commits: data.count,
+        percentage: Math.round((data.count / total) * 100),
+        lastTouched: data.lastDate,
+    }))
+        .sort((a, b) => b.commits - a.commits);
+}
+//# sourceMappingURL=git.js.map

package/bin/src/engine/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAEvD,MAAM,GAAG,GAAc,SAAS,EAAE,CAAC;AASnC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IAExB,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3B,MAAM,KAAK,GAAwD,EAAE,CAAC;IAEtE,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SACzB,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,MAAM;QACN,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;QAClD,WAAW,EAAE,IAAI,CAAC,QAAQ;KAC3B,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/bin/src/engine/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["llm.ts"],"names":[],"mappings":"AAcA,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,EACnB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqC7F"}

package/bin/src/engine/llm.js

@@ -0,0 +1,49 @@
+import OpenAI from 'openai';
+import dotenv from 'dotenv';
+import * as url from 'url';
+import path from 'path';
+const __dirname = url.fileURLToPath(new URL('.', import.meta.url));
+// Attempt to load .env from the root of the CLI installation
+dotenv.config({ path: path.resolve(__dirname, '../../../.env'), quiet: true });
+const openai = new OpenAI({
+    apiKey: process.env.GROQ_API_KEY || 'missing-key',
+    baseURL: 'https://api.groq.com/openai/v1',
+});
+export async function generateRepoSummary(projectName, filesList, packageJsonContent) {
+    const prompt = `
+You are an expert developer co-pilot summarizing a codebase for a new engineer.
+Project Name: ${projectName}
+File Tree Overview:
+${filesList.join('\n')}
+
+package.json:
+${packageJsonContent}
+
+Provide a JSON output matching this schema:
+{
+  "summary": "1-2 sentence description of what this project does and its core stack",
+  "entryPoint": "the primary entry point file path",
+  "readOrder": ["file1", "file2", "file3"],
+  "painPoints": ["known architectural risk or complex folder"]
+}
+`;
+    try {
+        const response = await openai.chat.completions.create({
+            model: 'llama-3.3-70b-versatile',
+            messages: [{ role: 'user', content: prompt }],
+            response_format: { type: 'json_object' },
+        });
+        return JSON.parse(response.choices[0]?.message?.content || '{}');
+    }
+    catch (error) {
+        console.error("OpenAI Error:", error);
+        // Fallback if no API key or network failure
+        return {
+            summary: `${projectName} (Static Analysis)`,
+            entryPoint: 'src/index.ts',
+            readOrder: ['package.json', 'src/index.ts'],
+            painPoints: ['LLM key missing — run with GROQ_API_KEY for deep AI insights.'],
+        };
+    }
+}
+//# sourceMappingURL=llm.js.map

package/bin/src/engine/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["llm.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAC3B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/E,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,aAAa;IACjD,OAAO,EAAE,gCAAgC;CAC1C,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,SAAmB,EACnB,kBAA0B;IAE1B,MAAM,MAAM,GAAG;;gBAED,WAAW;;EAEzB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGpB,kBAAkB;;;;;;;;;CASnB,CAAC;IAEA,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACpD,KAAK,EAAE,yBAAyB;YAChC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAC7C,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;SACzC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACtC,4CAA4C;QAC5C,OAAO;YACL,OAAO,EAAE,GAAG,WAAW,oBAAoB;YAC3C,UAAU,EAAE,cAAc;YAC1B,SAAS,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;YAC3C,UAAU,EAAE,CAAC,+DAA+D,CAAC;SAC9E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/bin/src/engine/scanners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanners.d.ts","sourceRoot":"","sources":["scanners.ts"],"names":[],"mappings":""}

package/bin/src/engine/scanners.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scanners.js.map

package/bin/src/engine/scanners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanners.js","sourceRoot":"","sources":["scanners.ts"],"names":[],"mappings":""}

package/bin/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":""}

package/bin/src/index.js

@@ -0,0 +1,48 @@
+import { Command } from 'commander';
+import { intro, outro } from '@clack/prompts';
+import chalk from 'chalk';
+import { handleInit } from './commands/init.js';
+import { handleBrief } from './commands/brief.js';
+import { handleOwners } from './commands/owners.js';
+import { handleRisky } from './commands/risky.js';
+import { handleSetup } from './commands/setup.js';
+const program = new Command();
+program
+    .command('risky')
+    .description('Show code fragility map based on churn and hotfixes')
+    .action(async () => handleRisky());
+program
+    .command('setup')
+    .description('Diagnose local setup, missing .env files, and runtime mismatches')
+    .action(async () => handleSetup());
+program
+    .name('ft')
+    .description('FrontTerrain — The Onboarding Co-Pilot for New Codebases')
+    .version('0.1.0');
+// Header UI on execution
+program.hook('preAction', () => {
+    intro(chalk.bgCyan.black(' FrontTerrain CLI (v0.1.0) '));
+});
+// Command definitions
+program
+    .command('init [repoUrl]')
+    .description('Build local understanding map of the repository')
+    .action(async (repoUrl) => {
+    await handleInit(repoUrl);
+    outro(chalk.green('Initialization complete! Run `ft brief` to get started.'));
+});
+program
+    .command('brief')
+    .description('Print human-readable onboarding summary')
+    .action(async () => {
+    await handleBrief();
+    outro(chalk.cyan('Ready for your first task.'));
+});
+program
+    .command('owners <path>')
+    .description('Show actual file knowledge holders based on git history')
+    .action(async (path) => {
+    await handleOwners(path);
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/bin/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAErC,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,kEAAkE,CAAC;KAC/E,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAGrC,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,0DAA0D,CAAC;KACvE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,yBAAyB;AACzB,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;IAC7B,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,sBAAsB;AACtB,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,iDAAiD,CAAC;KAC9D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IAC1B,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC,CAAC;AAChF,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,WAAW,EAAE,CAAC;IACpB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,yDAAyD,CAAC;KACtE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/src/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,QAK5C;AAED,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAGhD"}

package/bin/src/utils/config.js

@@ -0,0 +1,16 @@
+import fs from 'fs';
+import path from 'path';
+const FT_DIR = path.join(process.cwd(), '.ft');
+const CONTEXT_FILE = path.join(FT_DIR, 'context.json');
+export function saveContext(data) {
+    if (!fs.existsSync(FT_DIR)) {
+        fs.mkdirSync(FT_DIR, { recursive: true });
+    }
+    fs.writeFileSync(CONTEXT_FILE, JSON.stringify(data, null, 2));
+}
+export function loadContext() {
+    if (!fs.existsSync(CONTEXT_FILE))
+        return null;
+    return JSON.parse(fs.readFileSync(CONTEXT_FILE, 'utf-8'));
+}
+//# sourceMappingURL=config.js.map

package/bin/src/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAWxB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;AAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEvD,MAAM,UAAU,WAAW,CAAC,IAAiB;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/bin/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["logger.ts"],"names":[],"mappings":""}

package/bin/src/utils/logger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.js.map

package/bin/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["logger.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "ft-scout",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "FrontTerrain — The Onboarding Co-Pilot for New Codebases",
+  "main": "index.js",
+  "bin": {
+    "ft": "bin/ft.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc"
+  },
+  "keywords": [
+    "cli",
+    "onboarding",
+    "git",
+    "llm",
+    "ai"
+  ],
+  "author": "rishi",
+  "license": "ISC",
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "chalk": "^6.0.0",
+    "commander": "^15.0.0",
+    "dotenv": "^17.4.2",
+    "openai": "^7.1.0",
+    "simple-git": "^3.36.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "tsx": "^4.23.1",
+    "typescript": "^7.0.2"
+  }
+}