ft-scout 1.0.7 → 1.0.8

package/.ft/context.json

@@ -1,16 +1,18 @@
 {
-  "projectName": "SVMWebsite-1785424647835",
-  "stack": "This project is a simple website with a backend for admin uploads for Saraswati Vidya Mandir, built using Node.js, Express, and Firebase. The core stack includes Express for the server, Firebase for hosting and authentication, and various dependencies for file uploads and JSON Web Tokens.",
-  "entryPoint": "server.js",
+  "projectName": "FrontTerrainApp",
+  "repoUrl": "https://github.com/dark2quasar/Front-Terrain/FrontTerrainApp.git",
+  "targetDir": "C:\\Users\\rishi\\AppData\\Local\\Temp\\ft-scout-repos\\FrontTerrainApp-1785465176613",
+  "stack": "The FrontTerrainApp project is a social media application built with Flutter and React, utilizing Firebase for hosting and backend services. Its core stack includes TypeScript, React, and Flutter, with a mix of JavaScript and Python scripts for specific tasks.",
+  "entryPoint": "lib/main.dart",
   "painPoints": [
-    "large number of static HTML files (e.g., about-us.html, admin.html, etc.)",
-    "potential CORS issues with the Cors dependency",
-    "file upload handling with Multer"
+    "Complex folder structure with multiple build configurations",
+    "Usage of both Flutter and React, potentially leading to inconsistencies in code style and architecture"
   ],
   "readOrder": [
-    "server.js",
+    "lib/main.dart",
     "package.json",
-    "script.js"
+    "pubspec.yaml",
+    "firebase.json"
   ],
-  "createdAt": "2026-07-30T15:17:40.015Z"
+  "createdAt": "2026-07-31T02:33:02.673Z"
 }

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["init.ts"],"names":[],"mappings":"AASA,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,iBAyHhD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["init.ts"],"names":[],"mappings":"AAsFA,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,iBA8LhD"}

package/bin/src/commands/init.js

@@ -1,49 +1,167 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
-import { spinner, note } from '@clack/prompts';
+import { spinner, note, password, isCancel } from '@clack/prompts';
 import chalk from 'chalk';
 import { simpleGit } from 'simple-git';
 import { generateRepoSummary } from '../engine/llm.js';
 import { saveContext } from '../utils/config.js';
+function extractNpmPackageName(target) {
+    if (target.startsWith('npm:')) {
+        return target.slice(4).trim();
+    }
+    const npmUrlMatch = target.match(/^https?:\/\/(?:www\.)?npmjs\.com\/package\/(@?[^/]+(?:\/[^/]+)?)/i);
+    if (npmUrlMatch && npmUrlMatch[1]) {
+        return npmUrlMatch[1];
+    }
+    const isGitOrFile = /^https?:\/\//i.test(target) ||
+        /^git@/i.test(target) ||
+        target.includes('github.com') ||
+        target.includes('gitlab.com') ||
+        target.endsWith('.git');
+    if (!isGitOrFile) {
+        if (/^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/i.test(target)) {
+            return target;
+        }
+    }
+    return null;
+}
+async function getNpmRepoUrl(pkgName) {
+    try {
+        const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(pkgName)}`);
+        if (!res.ok) {
+            return null;
+        }
+        const data = (await res.json());
+        const repo = data.repository;
+        if (!repo)
+            return null;
+        let url = typeof repo === 'string' ? repo : repo.url;
+        if (!url)
+            return null;
+        url = url.replace(/^git\+/, '');
+        url = url.replace(/^git:\/\//, 'https://');
+        url = url.replace(/^ssh:\/\/git@github\.com\//, 'https://github.com/');
+        url = url.replace(/^git@github\.com:/, 'https://github.com/');
+        if (url.startsWith('github:')) {
+            url = `https://github.com/${url.replace('github:', '')}.git`;
+        }
+        if (url.startsWith('gitlab:')) {
+            url = `https://gitlab.com/${url.replace('gitlab:', '')}.git`;
+        }
+        if (url.startsWith('bitbucket:')) {
+            url = `https://bitbucket.org/${url.replace('bitbucket:', '')}.git`;
+        }
+        return url;
+    }
+    catch {
+        return null;
+    }
+}
+function cleanGitHubUrl(targetUrl) {
+    if (targetUrl.includes('github.com')) {
+        const match = targetUrl.match(/github\.com\/([^/]+(?:\/[^/]+)+)/i);
+        if (match && match[1]) {
+            let parts = match[1].split('/').filter(Boolean);
+            const branchIndex = parts.findIndex((p) => ['tree', 'blob', 'src'].includes(p.toLowerCase()));
+            if (branchIndex !== -1) {
+                parts = parts.slice(0, branchIndex);
+            }
+            const cleanParts = parts.map((p, i) => (i === parts.length - 1 ? p.replace(/\.git$/i, '') : p));
+            if (cleanParts.length >= 2) {
+                const owner = cleanParts[cleanParts.length - 2];
+                const repo = cleanParts[cleanParts.length - 1];
+                return `https://github.com/${owner}/${repo}.git`;
+            }
+        }
+    }
+    return targetUrl;
+}
 export async function handleInit(repoUrl) {
     const s = spinner();
     let targetDir = process.cwd();
     if (repoUrl && repoUrl.trim()) {
         const rawTarget = repoUrl.trim();
-        // Check if it's a URL or Git SSH string
-        const isUrl = /^https?:\/\//i.test(rawTarget) ||
-            /^git@/i.test(rawTarget) ||
-            rawTarget.includes('github.com') ||
-            rawTarget.includes('gitlab.com');
-        if (isUrl) {
-            s.start(`Cloning remote repository (${rawTarget})...`);
-            try {
-                const repoName = path.basename(rawTarget, '.git') || 'cloned-repo';
-                const tempParent = path.join(os.tmpdir(), 'ft-scout-repos');
-                targetDir = path.join(tempParent, `${repoName}-${Date.now()}`);
-                if (!fs.existsSync(tempParent)) {
-                    fs.mkdirSync(tempParent, { recursive: true });
+        const resolvedPath = path.resolve(rawTarget);
+        if (fs.existsSync(resolvedPath) && fs.statSync(resolvedPath).isDirectory()) {
+            targetDir = resolvedPath;
+        }
+        else {
+            let gitTargetUrl = cleanGitHubUrl(rawTarget);
+            const npmPkgName = extractNpmPackageName(rawTarget);
+            const isGitUrl = (/^https?:\/\//i.test(rawTarget) && !rawTarget.includes('npmjs.com')) ||
+                /^git@/i.test(rawTarget) ||
+                rawTarget.includes('github.com') ||
+                rawTarget.includes('gitlab.com') ||
+                rawTarget.endsWith('.git');
+            if (npmPkgName && !isGitUrl) {
+                s.start(`Resolving npm package repository (${chalk.cyan(npmPkgName)})...`);
+                const resolvedUrl = await getNpmRepoUrl(npmPkgName);
+                if (!resolvedUrl) {
+                    s.stop(chalk.red(`Failed to resolve npm package repository.`));
+                    note(chalk.red(`The specified repository is private or does not exist.`), '❌ Invalid Target');
+                    return;
                 }
-                const git = simpleGit();
-                await git.clone(rawTarget, targetDir, ['--depth', '1']);
-                s.stop(`Remote repository cloned successfully.`);
+                gitTargetUrl = cleanGitHubUrl(resolvedUrl);
+                s.stop(`Resolved npm package to repository ${chalk.cyan(gitTargetUrl)}.`);
             }
-            catch (err) {
-                s.stop(chalk.red(`Failed to clone remote repository.`));
-                note(chalk.red(`Error: ${err?.message || err}`), '❌ Clone Error');
-                return;
+            s.start(`Cloning remote repository (${chalk.cyan(gitTargetUrl)})...`);
+            const repoName = path.basename(gitTargetUrl, '.git') || 'cloned-repo';
+            const tempParent = path.join(os.tmpdir(), 'ft-scout-repos');
+            targetDir = path.join(tempParent, `${repoName}-${Date.now()}`);
+            if (!fs.existsSync(tempParent)) {
+                fs.mkdirSync(tempParent, { recursive: true });
             }
-        }
-        else {
-            // Local directory path
-            const resolvedPath = path.resolve(rawTarget);
-            if (fs.existsSync(resolvedPath) && fs.statSync(resolvedPath).isDirectory()) {
-                targetDir = resolvedPath;
+            const git = simpleGit();
+            try {
+                await git.clone(gitTargetUrl, targetDir, ['--depth', '1']);
+                s.stop(`Remote repository cloned successfully.`);
             }
-            else {
-                note(chalk.red(`Directory not found: ${rawTarget}\nPlease provide a valid local path or Git repository URL.`), '❌ Invalid Target');
-                return;
+            catch (err) {
+                s.stop(chalk.yellow(`Initial clone failed (repository may be private or require authentication).`));
+                // Interactive login / token prompt for private repos
+                if (gitTargetUrl.startsWith('https://')) {
+                    const tokenInput = await password({
+                        message: 'Enter your GitHub / GitLab Personal Access Token (PAT) to access this private repository:',
+                        mask: '*',
+                        validate: (val) => (!val || !val.trim() ? 'Token cannot be empty' : undefined),
+                    });
+                    if (!isCancel(tokenInput) && typeof tokenInput === 'string' && tokenInput.trim()) {
+                        const cleanToken = tokenInput.trim();
+                        // Inject token into URL: https://<token>@github.com/...
+                        const authenticatedUrl = gitTargetUrl.replace(/^https:\/\//i, `https://${cleanToken}@`);
+                        const retrySpinner = spinner();
+                        retrySpinner.start(`Retrying clone with provided token...`);
+                        try {
+                            if (fs.existsSync(targetDir)) {
+                                fs.rmSync(targetDir, { recursive: true, force: true });
+                            }
+                            await git.clone(authenticatedUrl, targetDir, ['--depth', '1']);
+                            retrySpinner.stop(chalk.green(`Remote repository cloned successfully!`));
+                        }
+                        catch (retryErr) {
+                            retrySpinner.stop(chalk.red(`Authentication failed with the provided token.`));
+                            note(chalk.red(`Could not clone repository with the provided token.\n` +
+                                `Please check that your token has repo read permissions.\n\n` +
+                                `Alternative options:\n` +
+                                ` • Use SSH: ${chalk.cyan('ft init git@github.com:owner/repo.git')}\n` +
+                                ` • Or clone locally first: ${chalk.cyan('ft init ./my-repo-folder')}`), '❌ Authentication Failed');
+                            return;
+                        }
+                    }
+                    else {
+                        note(chalk.yellow('Login cancelled. Repository initialization aborted.'), '❌ Clone Cancelled');
+                        return;
+                    }
+                }
+                else {
+                    note(chalk.red(`The specified repository is private or does not exist.\n\n` +
+                        chalk.bold('🔒 How to access private repositories:') + '\n' +
+                        ` • Use SSH URL: ${chalk.cyan('ft init git@github.com:owner/repo.git')}\n` +
+                        ` • Or use PAT Token URL: ${chalk.cyan('ft init https://<TOKEN>@github.com/owner/repo.git')}\n` +
+                        ` • Or clone locally first and run: ${chalk.cyan('ft-scout init ./my-repo-folder')}`), '❌ Clone Error');
+                    return;
+                }
             }
         }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["init.ts"],"names":[],"mappings":"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"}

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

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

package/bin/src/commands/owners.js

@@ -1,2 +1,45 @@
-export async function handleOwners(path) { }
+import { spinner, note } from '@clack/prompts';
+import chalk from 'chalk';
+import { getFileOwners } from '../engine/git.js';
+export async function handleOwners(targetPath) {
+    const s = spinner();
+    s.start(`Analyzing git history for ${chalk.cyan(targetPath)}...`);
+    if (!targetPath || !targetPath.trim()) {
+        s.stop(chalk.red('No path provided.'));
+        note(chalk.red('Please specify a file or directory path, e.g. `ft owners src/index.ts`'), '👥 File Knowledge Holders');
+        return;
+    }
+    if (/^https?:\/\//i.test(targetPath) ||
+        /^git@/i.test(targetPath) ||
+        targetPath.includes('github.com') ||
+        targetPath.includes('gitlab.com')) {
+        s.stop(chalk.yellow('Remote repository URL detected.'));
+        note(`\`ft owners\` is designed for local files and directories (e.g. ${chalk.cyan('ft owners src/index.ts')} or ${chalk.cyan('ft owners .')}).\n\nTo onboard and index a remote repository, please run:\n  ${chalk.cyan(`ft init ${targetPath}`)}`, '💡 Usage Tip');
+        return;
+    }
+    try {
+        const owners = await getFileOwners(targetPath);
+        if (owners.length === 0) {
+            s.stop('Ownership analysis complete.');
+            note(chalk.yellow(`No commit history found for "${targetPath}". Make sure the file exists and is tracked by Git.`), '👥 File Knowledge Holders');
+            return;
+        }
+        s.stop('Ownership analysis complete.');
+        const formattedList = owners
+            .map((o, idx) => {
+            const rank = chalk.bold(`#${idx + 1}`);
+            const pct = chalk.green(`${o.percentage}%`);
+            const dateStr = o.lastTouched
+                ? chalk.dim(`(last active: ${new Date(o.lastTouched).toLocaleDateString()})`)
+                : '';
+            return ` ${rank} ${chalk.bold(o.author)} — ${pct} (${o.commits} commit${o.commits > 1 ? 's' : ''}) ${dateStr}`;
+        })
+            .join('\n');
+        note(`Target: ${chalk.bold.cyan(targetPath)}\n\n${chalk.bold('Knowledge Holders:')}\n${formattedList}`, '👥 File Knowledge Holders');
+    }
+    catch (err) {
+        s.stop(chalk.red('Ownership analysis failed.'));
+        note(chalk.red(`Could not fetch git history for "${targetPath}". Make sure this is a valid git repository.\nError: ${err?.message || err}`), '👥 File Knowledge Holders');
+    }
+}
 //# sourceMappingURL=owners.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"owners.js","sourceRoot":"","sources":["owners.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,IAAG,CAAC"}
+{"version":3,"file":"owners.js","sourceRoot":"","sources":["owners.ts"],"names":[],"mappings":"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"}

package/bin/src/index.js

@@ -18,10 +18,10 @@ program
 program
     .name('ft')
     .description('FrontTerrain — The Onboarding Co-Pilot for New Codebases')
-    .version('1.0.7');
+    .version('1.0.8');
 // Header UI on execution
 program.hook('preAction', () => {
-    intro(chalk.bgCyan.black(' FrontTerrain CLI (v1.0.7) '));
+    intro(chalk.bgCyan.black(' FrontTerrain CLI (v1.0.8) '));
 });
 // Command definitions
 program
@@ -43,6 +43,7 @@ program
     .description('Show actual file knowledge holders based on git history')
     .action(async (path) => {
     await handleOwners(path);
+    outro(chalk.cyan('File ownership analysis complete.'));
 });
 program.parse(process.argv);
 //# sourceMappingURL=index.js.map

package/bin/src/index.js.map

@@ -1 +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"}
+{"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;IACzB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/email-template.html

@@ -0,0 +1,223 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Introducing FrontTerrain (ft-scout)</title>
+  <style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
+      background-color: #0f172a;
+      margin: 0;
+      padding: 40px 12px;
+      color: #e2e8f0;
+    }
+    .container {
+      max-width: 620px;
+      margin: 0 auto;
+      background: #1e293b;
+      border-radius: 16px;
+      overflow: hidden;
+      box-shadow: 0 10px 30px rgba(0, 0, 0, 0.4);
+      border: 1px solid #334155;
+    }
+    .header {
+      background: linear-gradient(135deg, #0284c7 0%, #0d9488 100%);
+      padding: 40px 30px;
+      text-align: center;
+      color: #ffffff;
+    }
+    .badge {
+      display: inline-block;
+      background: rgba(255, 255, 255, 0.2);
+      color: #ffffff;
+      font-size: 11px;
+      font-weight: 700;
+      padding: 4px 14px;
+      border-radius: 20px;
+      text-transform: uppercase;
+      letter-spacing: 1px;
+      margin-bottom: 12px;
+    }
+    .header h1 {
+      margin: 0;
+      font-size: 28px;
+      font-weight: 800;
+      letter-spacing: -0.5px;
+    }
+    .header p {
+      margin-top: 10px;
+      color: #e0f2fe;
+      font-size: 16px;
+      font-weight: 400;
+    }
+    .content {
+      padding: 36px 30px;
+    }
+    .intro {
+      font-size: 16px;
+      line-height: 1.7;
+      color: #cbd5e1;
+      margin-bottom: 28px;
+    }
+    .section-title {
+      font-size: 18px;
+      font-weight: 700;
+      color: #f8fafc;
+      margin-bottom: 16px;
+      display: flex;
+      align-items: center;
+    }
+    .feature-card {
+      background: #0f172a;
+      border: 1px solid #334155;
+      border-radius: 12px;
+      padding: 20px;
+      margin-bottom: 16px;
+      transition: transform 0.2s;
+    }
+    .feature-header {
+      display: flex;
+      align-items: center;
+      margin-bottom: 8px;
+    }
+    .command-tag {
+      background: #0284c7;
+      color: #ffffff;
+      font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
+      font-weight: 700;
+      font-size: 13px;
+      padding: 4px 10px;
+      border-radius: 6px;
+      margin-right: 10px;
+    }
+    .feature-name {
+      font-weight: 700;
+      font-size: 16px;
+      color: #f8fafc;
+    }
+    .feature-desc {
+      font-size: 14px;
+      color: #94a3b8;
+      margin: 0;
+      line-height: 1.6;
+    }
+    .code-box {
+      background: #090d16;
+      color: #38bdf8;
+      padding: 20px;
+      border-radius: 10px;
+      font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
+      font-size: 14px;
+      line-height: 1.8;
+      margin: 28px 0;
+      border: 1px solid #1e293b;
+    }
+    .code-box span.comment {
+      color: #64748b;
+    }
+    .code-box span.cmd {
+      color: #4ade80;
+    }
+    .cta-container {
+      text-align: center;
+      margin: 36px 0 20px 0;
+    }
+    .btn {
+      background: linear-gradient(135deg, #0284c7 0%, #0d9488 100%);
+      color: #ffffff !important;
+      padding: 16px 36px;
+      border-radius: 10px;
+      text-decoration: none;
+      font-weight: 700;
+      display: inline-block;
+      font-size: 16px;
+      box-shadow: 0 4px 14px rgba(2, 132, 199, 0.4);
+    }
+    .footer {
+      background: #0f172a;
+      text-align: center;
+      padding: 24px;
+      font-size: 13px;
+      color: #64748b;
+      border-top: 1px solid #334155;
+    }
+    .footer a {
+      color: #38bdf8;
+      text-decoration: none;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <span class="badge">V1.0.8 RELEASE</span>
+      <h1>FrontTerrain (<code>ft-scout</code>)</h1>
+      <p>The AI Onboarding Co-Pilot for New Codebases</p>
+    </div>
+    
+    <div class="content">
+      <p class="intro">
+        Hey FrontTerrain Developer 👋,<br><br>
+        Jumping into a massive or legacy codebase can be intimidating. You waste hours deciphering complex file structures, guessing who owns which module, or accidentally editing fragile hotspots.<br><br>
+        That’s why we built <strong><code>ft-scout</code> (FrontTerrain CLI)</strong> — your AI co-pilot designed to give you instant codebase clarity directly inside your terminal!
+      </p>
+
+      <div class="section-title">⚡ What You Can Do with <code>ft-scout</code>:</div>
+
+      <div class="feature-card">
+        <div class="feature-header">
+          <span class="command-tag">ft brief</span>
+          <span class="feature-name">AI Onboarding Summary</span>
+        </div>
+        <p class="feature-desc">Get an instant, human-readable summary of repository architecture, tech stack, and key modules so you can start contributing immediately.</p>
+      </div>
+
+      <div class="feature-card">
+        <div class="feature-header">
+          <span class="command-tag">ft risky</span>
+          <span class="feature-name">Code Fragility Risk Map</span>
+        </div>
+        <p class="feature-desc">Analyzes commit churn, hotfixes, and historical regressions to alert you about high-risk hotspots and line ranges before you touch them.</p>
+      </div>
+
+      <div class="feature-card">
+        <div class="feature-header">
+          <span class="command-tag">ft owners &lt;path&gt;</span>
+          <span class="feature-name">Domain Knowledge Holders</span>
+        </div>
+        <p class="feature-desc">Identifies true code experts based on real commit frequency and authorship—so you know exactly who to loop into code reviews.</p>
+      </div>
+
+      <div class="feature-card">
+        <div class="feature-header">
+          <span class="command-tag">ft setup</span>
+          <span class="feature-name">Local Dev Diagnostic</span>
+        </div>
+        <p class="feature-desc">Automatically scans missing <code>.env</code> keys, node runtime mismatches, and configuration issues before they break your local build.</p>
+      </div>
+
+      <div class="section-title" style="margin-top: 32px;">🚀 Quick Start Guide</div>
+
+      <div class="code-box">
+        <span class="comment"># 1. Install ft-scout globally via npm</span><br>
+        <span class="cmd">npm install -g ft-scout</span><br><br>
+        <span class="comment"># 2. Run inside any Git codebase</span><br>
+        <span class="cmd">ft init</span><br><br>
+        <span class="comment"># 3. Get your onboarding brief & risk map</span><br>
+        <span class="cmd">ft brief</span><br>
+        <span class="cmd">ft risky</span>
+      </div>
+
+      <div class="cta-container">
+        <a href="https://github.com/Front-Terrain/FT-Check#readme" class="btn" target="_blank">Explore Documentation & GitHub</a>
+      </div>
+    </div>
+
+    <div class="footer">
+      <p>Built with ❤️ by Front Terrain</p>
+      <p><a href="https://github.com/Front-Terrain/FT-Check">GitHub Repository</a> | <a href="https://github.com/Front-Terrain/FT-Check/issues">Report Issues</a></p>
+    </div>
+  </div>
+</body>
+</html>

package/email-template.txt

@@ -0,0 +1,45 @@
+Subject: 🚀 Introducing FrontTerrain (ft-scout): Your AI Onboarding Co-Pilot for Codebases
+Preheader: Instant codebase summaries, fragility risk maps, and knowledge owner detection in your terminal.
+
+Hey FrontTerrain Developer 👋,
+
+Jumping into a massive or legacy codebase can be intimidating. You waste hours deciphering complex file structures, guessing who owns which module, or accidentally editing fragile hotspots.
+
+That’s why we built ft-scout (FrontTerrain CLI v1.0.7) — your AI co-pilot designed to give you instant codebase clarity directly inside your terminal!
+
+---
+
+⚡ WHAT YOU CAN DO WITH FT-SCOUT:
+
+1. ft brief — AI Onboarding Summary
+   Get an instant, human-readable summary of repository architecture, tech stack, and key modules so you can start contributing immediately.
+
+2. ft risky — Code Fragility Risk Map
+   Analyzes commit churn, hotfixes, and historical regressions to alert you about high-risk hotspots and line ranges before you touch them.
+
+3. ft owners <path> — Domain Knowledge Holders
+   Identifies true code experts based on real commit frequency and authorship—so you know exactly who to loop into code reviews.
+
+4. ft setup — Local Dev Diagnostic
+   Automatically scans missing .env keys, node runtime mismatches, and configuration issues before they break your local build.
+
+---
+
+🚀 QUICK START GUIDE:
+
+1. Install ft-scout globally via npm:
+   $ npm install -g ft-scout
+
+2. Run inside any Git codebase:
+   $ ft init
+
+3. Get your onboarding brief & risk map:
+   $ ft brief
+   $ ft risky
+
+---
+
+🔗 GitHub & Documentation: https://github.com/Front-Terrain/FT-Check#readme
+
+Happy Coding! 🚀
+Front Terrain Team

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ft-scout",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "type": "module",
   "description": "FrontTerrain — The Onboarding Co-Pilot for New Codebases",
   "main": "index.js",

package/scripts/send-brevo-campaign.cjs

@@ -0,0 +1,167 @@
+const fs = require('fs');
+const path = require('path');
+
+// Try requiring nodemailer from FrontTerrain if not in current node_modules
+let nodemailer;
+try {
+  nodemailer = require('nodemailer');
+} catch {
+  try {
+    nodemailer = require('C:/Users/rishi/FrontTerrain/node_modules/nodemailer');
+  } catch {
+    nodemailer = require('C:/Users/rishi/FrontTerrain/functions/node_modules/nodemailer');
+  }
+}
+
+// Try requiring firebase-admin from FrontTerrain
+let admin;
+try {
+  admin = require('firebase-admin');
+} catch {
+  try {
+    admin = require('C:/Users/rishi/FrontTerrain/node_modules/firebase-admin');
+  } catch {
+    admin = require('C:/Users/rishi/FrontTerrain/functions/node_modules/firebase-admin');
+  }
+}
+
+const serviceAccountPath = 'C:/Users/rishi/FrontTerrain/ServiceAccountKey.json';
+
+const BREVO_USER = 'b23077001@smtp-brevo.com';
+const BREVO_PASS = 'xsmtpsib-63ad84e2307ca830b499c8921f1a242cab01b6f938119cf453e81ab854f643a3-RLpSOgjpmtGZN1NT';
+const FROM_EMAIL = '"FrontTerrain" <noreply@frontterrain.com>';
+const SUBJECT = '🚀 Introducing FrontTerrain (ft-scout): Your AI Onboarding Co-Pilot for Codebases';
+
+const htmlPath = path.join(__dirname, '../email-template.html');
+const textPath = path.join(__dirname, '../email-template.txt');
+
+const htmlContent = fs.readFileSync(htmlPath, 'utf8');
+const textContent = fs.readFileSync(textPath, 'utf8');
+
+const transporter = nodemailer.createTransport({
+  host: 'smtp-relay.brevo.com',
+  port: 587,
+  secure: false,
+  auth: {
+    user: BREVO_USER,
+    pass: BREVO_PASS,
+  },
+});
+
+async function getAllUserEmails() {
+  const emails = new Set();
+
+  if (fs.existsSync(serviceAccountPath)) {
+    try {
+      const serviceAccount = require(serviceAccountPath);
+      if (!admin.apps.length) {
+        admin.initializeApp({
+          credential: admin.credential.cert(serviceAccount),
+        });
+      }
+
+      // Fetch from Firestore users collection
+      const db = admin.firestore();
+      const snapshot = await db.collection('users').get();
+      snapshot.forEach((doc) => {
+        const data = doc.data();
+        if (data.email) emails.add(data.email.trim().toLowerCase());
+      });
+
+      // Fetch from Firebase Auth users list
+      let nextPageToken;
+      do {
+        const listUsersResult = await admin.auth().listUsers(1000, nextPageToken);
+        listUsersResult.users.forEach((userRecord) => {
+          if (userRecord.email) emails.add(userRecord.email.trim().toLowerCase());
+        });
+        nextPageToken = listUsersResult.pageToken;
+      } while (nextPageToken);
+    } catch (err) {
+      console.warn('⚠️  Could not fetch users from Firebase:', err.message);
+    }
+  }
+
+  // Also check if local users.json exists
+  const usersJsonPath = path.join(__dirname, '../users.json');
+  if (fs.existsSync(usersJsonPath)) {
+    try {
+      const localUsers = JSON.parse(fs.readFileSync(usersJsonPath, 'utf8'));
+      localUsers.forEach((e) => emails.add(e.trim().toLowerCase()));
+    } catch (e) {}
+  }
+
+  return Array.from(emails);
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const isSendMode = args.includes('--send');
+  const testEmailArg = args.find((a) => a.startsWith('--test='));
+  const testEmail = testEmailArg ? testEmailArg.split('=')[1] : null;
+
+  console.log('\n=================================================');
+  console.log('🚀 FrontTerrain ft-scout Brevo Email Dispatcher');
+  console.log('=================================================\n');
+
+  if (testEmail) {
+    console.log(`✉️  Sending test email to: ${testEmail}...`);
+    const info = await transporter.sendMail({
+      from: FROM_EMAIL,
+      to: testEmail,
+      subject: `${SUBJECT}`,
+      html: htmlContent,
+      text: textContent,
+    });
+    console.log(`✅ Test email sent successfully! MessageID: ${info.messageId || info.response}`);
+    return;
+  }
+
+  console.log('🔍 Fetching all FT users...');
+  const recipients = await getAllUserEmails();
+  console.log(`📊 Found ${recipients.length} total FT user email address(es):\n`);
+  recipients.forEach((email, i) => console.log(`   ${i + 1}. ${email}`));
+
+  if (recipients.length === 0) {
+    console.log('\n⚠️  No user emails found. Please verify Firebase connection or users.json file.');
+    return;
+  }
+
+  if (!isSendMode) {
+    console.log('\n-------------------------------------------------');
+    console.log('📌 DRY-RUN MODE (No emails sent).');
+    console.log('To send a test email first, run:');
+    console.log('  node scripts/send-brevo-campaign.cjs --test=your_email@domain.com\n');
+    console.log('To send to ALL users above, run:');
+    console.log('  node scripts/send-brevo-campaign.cjs --send');
+    console.log('-------------------------------------------------\n');
+    return;
+  }
+
+  console.log('\n🚀 Starting bulk email dispatch via Brevo SMTP...');
+  let successCount = 0;
+  let failCount = 0;
+
+  for (const email of recipients) {
+    try {
+      const info = await transporter.sendMail({
+        from: FROM_EMAIL,
+        to: email,
+        subject: SUBJECT,
+        html: htmlContent,
+        text: textContent,
+      });
+      successCount++;
+      console.log(`✅ [${successCount}/${recipients.length}] Sent to ${email} (MessageID: ${info.messageId || info.response})`);
+    } catch (err) {
+      failCount++;
+      console.error(`❌ Failed to send to ${email}:`, err.message);
+    }
+  }
+
+  console.log('\n=================================================');
+  console.log(`🎉 Campaign Complete: ${successCount} Sent, ${failCount} Failed.`);
+  console.log('=================================================\n');
+}
+
+main().catch(console.error);

package/scripts/send-email.js

@@ -0,0 +1,77 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+/**
+ * FrontTerrain (ft-scout) Email Dispatch Script
+ * 
+ * Usage:
+ * 1. Set environment variables:
+ *    export RESEND_API_KEY="re_123456789"
+ *    (or SENDGRID_API_KEY="SG.xxx")
+ * 2. Create `users.json` containing an array of emails:
+ *    ["user1@example.com", "user2@example.com"]
+ * 3. Run: node scripts/send-email.js
+ */
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const htmlTemplatePath = path.join(__dirname, '../email-template.html');
+const textTemplatePath = path.join(__dirname, '../email-template.txt');
+
+const htmlContent = fs.readFileSync(htmlTemplatePath, 'utf8');
+const textContent = fs.readFileSync(textTemplatePath, 'utf8');
+
+async function sendEmailResend(apiKey, recipients) {
+  console.log(`Sending email to ${recipients.length} recipients via Resend API...`);
+  
+  for (const email of recipients) {
+    try {
+      const response = await fetch('https://api.resend.com/emails', {
+        method: 'POST',
+        headers: {
+          'Authorization': `Bearer ${apiKey}`,
+          'Content-Type': 'application/json'
+        },
+        body: JSON.stringify({
+          from: 'FrontTerrain <updates@frontterrain.com>',
+          to: [email],
+          subject: '🚀 Introducing FrontTerrain (ft-scout): Your AI Onboarding Co-Pilot',
+          html: htmlContent,
+          text: textContent
+        })
+      });
+      const data = await response.json();
+      if (response.ok) {
+        console.log(`✅ Sent to ${email} (ID: ${data.id})`);
+      } else {
+        console.error(`❌ Failed to send to ${email}:`, data);
+      }
+    } catch (err) {
+      console.error(`❌ Error sending to ${email}:`, err.message);
+    }
+  }
+}
+
+async function main() {
+  const usersFilePath = path.join(__dirname, '../users.json');
+  if (!fs.existsSync(usersFilePath)) {
+    console.log('ℹ️  No users.json file found. Creating example users.json...');
+    fs.writeFileSync(usersFilePath, JSON.stringify(["user1@example.com", "user2@example.com"], null, 2));
+    console.log('📝 Please edit `users.json` with your real user emails list.');
+    return;
+  }
+
+  const recipients = JSON.parse(fs.readFileSync(usersFilePath, 'utf8'));
+  const resendApiKey = process.env.RESEND_API_KEY;
+
+  if (resendApiKey) {
+    await sendEmailResend(resendApiKey, recipients);
+  } else {
+    console.log('\n⚠️  No API Key detected.');
+    console.log('Set `RESEND_API_KEY` or copy the content from `email-template.html` / `email-template.txt` into Mailchimp/SendGrid/Brevo.');
+  }
+}
+
+main().catch(console.error);