@controlfront/detect 0.0.1

package/src/commands/snapshot.js

@@ -0,0 +1,191 @@
+/**
+ * snapshot.js
+ *
+ * Snapshot orchestrator.
+ *
+ * Responsibilities:
+ * - determine which files to scan
+ * - collect raw per-file indicators
+ *
+ * This file does NOT:
+ * - compute baselines
+ * - compare snapshots
+ * - infer drift, deltas, volatility, or causality
+ * - compute per-file characteristics
+ */
+
+import { collectFileIndicators } from "../fileCharacteristics/collectFileIndicators.js";
+import getAllFiles from "../utils/getAllFiles.js";
+import getCommitMetaData from "../utils/getCommitMetaData.js";
+import { buildBlameData } from "../utils/buildBlameData.js";
+import { buildFileChanges } from "../utils/buildFileChanges.js";
+import { buildDependencyMap } from "../utils/extractImports.js";
+import { generateAuthorId } from "../utils/authorId.js";
+
+/**
+ * Run a snapshot scan at the current commit.
+ *
+ * @param {{ files?: string[] }} options
+ */
+export async function runSnapshot(options = {}) {
+  const repoRoot = process.cwd();
+
+  // 1. Resolve files to scan
+  const files =
+    options.files && options.files.length > 0
+      ? options.files
+      : getAllFiles(repoRoot);
+
+  // 2. Collect raw indicators
+  const fileIndicators = await collectFileIndicators(files, { repoRoot });
+
+  // 2a. Build dependency map (imports + imported_by)
+  console.log("📦 Building dependency map...");
+  // Use the actual files from fileIndicators to ensure key matching
+  const indicatorFiles = Object.keys(fileIndicators);
+  const dependencyMap = buildDependencyMap(indicatorFiles, repoRoot);
+  
+  console.log(`📦 Dependency map built for ${indicatorFiles.length} files`);
+  
+  // Debug: find a JS/TS file sample
+  const jsTsFile = indicatorFiles.find(f => 
+    /\.(jsx?|tsx?|mjs|cjs)$/i.test(f)
+  );
+  
+  if (jsTsFile && dependencyMap[jsTsFile]) {
+    console.log(`📦 Sample JS/TS file: ${jsTsFile}`);
+    console.log(`   imports: ${dependencyMap[jsTsFile].imports.length}`);
+    console.log(`   imported_by: ${dependencyMap[jsTsFile].imported_by.length}`);
+    if (dependencyMap[jsTsFile].imports.length > 0) {
+      console.log(`   first import: ${dependencyMap[jsTsFile].imports[0]}`);
+    }
+  }
+
+  // 3. Assemble snapshot per file with indicators only
+  const filesSnapshot = {};
+
+  for (const [file, { indicators }] of Object.entries(fileIndicators)) {
+    const deps = dependencyMap[file] || { imports: [], imported_by: [] };
+    
+    filesSnapshot[file] = {
+      indicators: { ...indicators },
+      imports: deps.imports,
+      imported_by: deps.imported_by,
+    };
+  }
+
+  // 4. Attach commit metadata
+  const commit = getCommitMetaData();
+  
+  // Generate consistent author ID
+  const commitAuthorId = generateAuthorId({
+    email: commit.author_email,
+    name: commit.author,
+  });
+
+  // 4a. Build per-changed-file unified-0 diffs (+line ranges) and scoped blame stats (step 2)
+  // `buildBlameData` will derive the parent SHA (single-parent only) and skip merge/root commits.
+  const changedFilePaths = Array.isArray(commit.changed_files)
+    ? commit.changed_files
+        .map((cf) =>
+          (cf && typeof cf.path === "string" && cf.path) ||
+          (cf && typeof cf.file === "string" && cf.file) ||
+          (cf && typeof cf.to === "string" && cf.to) ||
+          (cf && typeof cf.from === "string" && cf.from) ||
+          null
+        )
+        .filter(Boolean)
+    : [];
+
+  let diffData = { status: "skipped", files: {} };
+  try {
+    if (commit && typeof commit.sha === "string" && commit.sha && changedFilePaths.length > 0) {
+      diffData = buildBlameData({
+        repoRoot,
+        commitSha: commit.sha,
+        filePaths: changedFilePaths,
+        commitTimestampIso: commit.timestamp || null,
+      });
+    }
+  } catch (_err) {
+    diffData = { status: "error", files: {} };
+  }
+
+  // Enrich changed_files with indicator context from the full snapshot.
+  // This keeps `files` as the full snapshot (baseline-safe) while making
+  // `changed_files` useful for downstream rollups and charts.
+  const enrichedChangedFiles = Array.isArray(commit.changed_files)
+    ? commit.changed_files.map((cf) => {
+        const path =
+          (cf && typeof cf.path === "string" && cf.path) ||
+          (cf && typeof cf.file === "string" && cf.file) ||
+          (cf && typeof cf.to === "string" && cf.to) ||
+          (cf && typeof cf.from === "string" && cf.from) ||
+          null;
+
+        const indicators =
+          path && filesSnapshot[path] && filesSnapshot[path].indicators
+            ? filesSnapshot[path].indicators
+            : null;
+
+        const imports =
+          path && filesSnapshot[path] && filesSnapshot[path].imports
+            ? filesSnapshot[path].imports
+            : [];
+
+        const importedBy =
+          path && filesSnapshot[path] && filesSnapshot[path].imported_by
+            ? filesSnapshot[path].imported_by
+            : [];
+
+        const diffForFile = path && diffData && diffData.files ? diffData.files[path] : null;
+
+        return {
+          ...cf,
+
+          // Stamp current-commit context onto each changed file entry.
+          // This is required for accurate cross-commit file sequencing.
+          commit_sha: commit.sha || null,
+          commit_timestamp: commit.timestamp || null,
+          commit_author: commit.author || null,
+          commit_author_email: commit.author_email || null,
+          commit_author_id: commitAuthorId,
+
+          indicators,
+          imports,
+          imported_by: importedBy,
+          diff_unified0: diffForFile ? diffForFile.diff_unified0 : null,
+          diff_ranges: diffForFile ? diffForFile.ranges : [],
+          blame_stats: diffForFile ? diffForFile.blame_stats : null,
+        };
+      })
+    : [];
+
+  // 4b. Build per-commit file change events (file-centric rows) for downstream sequencing.
+  // NOTE: This is a pure transform; persistence happens via the existing snapshots API.
+  const fileChanges = buildFileChanges({
+    projectId: options.projectId || options.project_id || null,
+    commit,
+    changedFiles: enrichedChangedFiles,
+  });
+
+  // 5. Emit snapshot payload
+  return {
+    commit_sha: commit.sha,
+    commit_author: commit.author,
+    author_email: commit.author_email || null,
+    commit_author_email: commit.author_email || null,
+    commit_author_id: commitAuthorId,
+    commit_branch: commit.branch,
+    commit_timestamp: commit.timestamp,
+    commit_message: commit.message || "",
+    diff_status: diffData && diffData.status ? diffData.status : "skipped",
+    blame_line_coverage_pct:
+      diffData && typeof diffData.line_coverage_pct === "number" ? diffData.line_coverage_pct : null,
+    changed_files: enrichedChangedFiles,
+    file_changes: fileChanges,
+    files: filesSnapshot,
+  };
+}
+
+export default runSnapshot;

package/src/commands/sync.js

@@ -0,0 +1,127 @@
+import fs from "fs";
+import fetch from "node-fetch";
+import os from "os";
+import path from "path";
+
+import open from "open";
+import { makeUrl, resolveBaseUrl } from "../config/baseUrl.js";
+
+import { runInit } from "./init.js";
+import { runLogin } from "./login.js";
+
+export async function runSync({
+  openWeb = true,
+  projectInfo,
+  token,
+  changedFiles,
+  slug,
+} = {}) {
+  const configPath = path.join(os.homedir(), ".cf", "config.json");
+  const reportPath = path.resolve(process.cwd(), "scan-report.json");
+  const insightsPath = path.resolve(process.cwd(), "insights.json");
+
+  if (!fs.existsSync(configPath)) {
+    console.log("🔐 No config found. Launching login flow...");
+    await runLogin();
+    await runInit();
+  }
+
+  if (!fs.existsSync(reportPath)) {
+    console.error("❌ scan-report.json not found. Run `cf scan` first.");
+    process.exit(1);
+  }
+
+  const resolvedWorkspace =
+    projectInfo?.workspace ||
+    (projectInfo?.project?.workspace_id
+      ? { id: projectInfo.project.workspace_id, name: "Unknown" }
+      : undefined);
+
+  if (!token) {
+    console.error("❌ Missing token. Please run `cf login`.");
+    process.exit(1);
+  }
+
+  if (!resolvedWorkspace?.id) {
+    console.error("❌ Missing workspace info. Please run `cf init`.");
+    process.exit(1);
+  }
+
+  if (!projectInfo?.project?.id) {
+    console.error("❌ Missing project info. Please run `cf init`.");
+    process.exit(1);
+  }
+
+  const scan = JSON.parse(fs.readFileSync(reportPath, "utf8"));
+
+  // IMPORTANT: when syncing an updated scan over an existing drift row, we must
+  // not send an `id` field back to the server. If we do, an overwrite/upsert can
+  // update the primary key and break stable URLs.
+  //
+  // We keep the rest of the payload intact; the server should decide whether to
+  // insert or update based on its own keys.
+  const scanForSync = { ...scan };
+  delete scanForSync.id;
+
+  console.log(
+    `📡 Syncing scan to ${resolvedWorkspace.name} / ${projectInfo.project.name}...`
+  );
+
+  try {
+    const res = await fetch(makeUrl(`/api/scans`), {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`,
+      },
+      body: JSON.stringify({
+        scan: {
+          ...scanForSync,
+          workspace_id: resolvedWorkspace.id,
+          project_id: projectInfo.project.id,
+          ...(changedFiles ? { changed_files: changedFiles } : {}),
+          slug: slug || "manual",
+        },
+      }),
+    });
+    const text = await res.text();
+    let data;
+    try {
+      data = JSON.parse(text);
+    } catch {
+      console.error(`❌ Server response is not valid JSON:\n${text}`);
+      return;
+    }
+    if (!res.ok) {
+      console.error(
+        `❌ Sync failed with status ${res.status}:\n${JSON.stringify(
+          data,
+          null,
+          2
+        )}`
+      );
+      return;
+    }
+    console.log("✅ Scan synced successfully to ControlFront.");
+    if (data?.id && data?.workspace_id && data?.project_id) {
+      const url = `${resolveBaseUrl()}/workspaces/${
+        data.workspace_id
+      }/projects/${data.project_id}/baseline`;
+      console.log(`👀 View scan report: ${url}`);
+
+      if (openWeb) {
+        try {
+          await open(url);
+        } catch (err) {
+          console.error("❌ Failed to open browser:", err.message);
+        }
+      }
+    }
+
+    if (!openWeb) {
+      console.log("🚫 Web app not opened (per --no-web-open flag).");
+    }
+  } catch (err) {
+    console.error("❌ Sync failed:", err.message);
+  }
+}

package/src/config/baseUrl.js

@@ -0,0 +1,49 @@
+import dotenv from "dotenv";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Load .env from CLI root (one directory up from /src/config/)
+dotenv.config({
+  path: path.join(__dirname, "..", "..", ".env"),
+  override: true,
+});
+
+export function getStoredEnvironment() {
+  try {
+    const configPath = path.join(os.homedir(), ".cf", "config.json");
+    if (fs.existsSync(configPath)) {
+      const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+      return config.environment || "dev";
+    }
+  } catch (e) {
+    // ignore errors
+  }
+  return "dev";
+}
+
+export function resolveBaseUrlForEnv(env) {
+  const url = env === "prod" 
+    ? process.env.CF_APP_URL_PROD 
+    : process.env.CF_APP_URL_DEV;
+  
+  if (url && url.trim()) {
+    return url.trim();
+  }
+  
+  // Fallback defaults
+  return env === "prod" ? "https://app.controlfront.io" : "http://localhost:3000";
+}
+
+export function resolveBaseUrl() {
+  const env = getStoredEnvironment();
+  return resolveBaseUrlForEnv(env);
+}
+
+export function makeUrl(pathAndQuery = "") {
+  return new URL(pathAndQuery, resolveBaseUrl() + "/").toString();
+}

package/src/data/tailwind-core-spec.js

@@ -0,0 +1,149 @@
+// Tailwind v3.x+ core patterns (no plugins). Keep this in JS so we can use regexes & helpers.
+// Covers: variants, breakpoints, colors/shades, sizing scale, radii, borders, typography,
+// layout, effects, transforms, interactivity, tables, accessibility, etc.
+
+const BREAKPOINTS = ["sm","md","lg","xl","2xl"];
+const STATE_VARIANTS = [
+  "hover","focus","focus-visible","active","disabled","visited","first","last","odd","even",
+  "checked","indeterminate","focus-within","required","valid","invalid","read-only","empty",
+  "placeholder","placeholder-shown","autofill","selection","target","open"
+];
+const GROUP_VARIANTS = [
+  "group-hover","group-focus","group-active","group-disabled","group-aria-[\\w:-]+","peer-hover",
+  "peer-focus","peer-active","peer-disabled","peer-checked","peer-invalid","peer-aria-[\\w:-]+"
+];
+// Tailwind also supports arbitrary variants in brackets like [@supports(display:grid)]:, etc.
+// We’ll just strip any leading "{variant}:" chunks before matching a base utility.
+
+export const VARIANT_PREFIX_RE = new RegExp(
+  // responsive + state + dark + rtl/ltr + print + motion + forced-colors + data-* + aria-* + arbitrary [...]
+  `^(?:(${[
+    ...BREAKPOINTS,
+    "dark","rtl","ltr","motion-safe","motion-reduce","portrait","landscape",
+    "print","contrast-more","contrast-less","forced-colors",
+    ...STATE_VARIANTS,
+  ].join("|")})|(?:data-[\\w-]+)|(?:aria-[\\w-]+)|(?:group\\/(?:[\\w-]+))|(?:group)|(?:peer)|(?:\$begin:math:display$.+?\\$end:math:display$)):`,
+  "g"
+);
+
+// Colors from the default palette (Tailwind v3)
+const COLORS = [
+  "inherit","current","transparent","black","white",
+  "slate","gray","zinc","neutral","stone",
+  "red","orange","amber","yellow","lime","green","emerald","teal","cyan","sky","blue",
+  "indigo","violet","purple","fuchsia","pink","rose"
+];
+const SHADES = ["50","100","200","300","400","500","600","700","800","900","950"];
+
+// Spacing scale (subset but representative of Tailwind defaults, expanded to cover common sizes)
+const SPACING_KEYS = [
+  "px","0","0\\.5","1","1\\.5","2","2\\.5","3","3\\.5","4","5","6","7","8","9","10",
+  "11","12","14","16","20","24","28","32","36","40","44","48","52","56","60","64","72","80","96"
+];
+
+// Fractions for width/height
+const FRACTIONS = ["1\\/2","1\\/3","2\\/3","1\\/4","2\\/4","3\\/4","1\\/5","2\\/5","3\\/5","4\\/5","1\\/6","2\\/6","3\\/6","4\\/6","5\\/6","full","screen","min","max","fit","auto"];
+
+// Font sizes
+const FONT_SIZES = ["xs","sm","base","lg","xl","2xl","3xl","4xl","5xl","6xl","7xl","8xl","9xl"];
+
+// Border radii
+const RADII = ["none","sm","", "md","lg","xl","2xl","3xl","full"]; // "" is default ("rounded")
+
+// Border widths
+const BORDER_W = ["0","2","4","8",""];
+
+// Z-index keywords
+const ZINDEX = ["0","10","20","30","40","50","auto"];
+
+// Opacity
+const OPACITY = ["0","5","10","20","25","30","40","50","60","70","75","80","90","95","100"];
+
+// Object fit/position, overflow, display, position, etc. are constant words, we’ll regex by namespace.
+
+const COLOR_CLASS = (ns) =>
+  new RegExp(`^${ns}-(?:${COLORS.join("|")})(?:-(?:${SHADES.join("|")}))?$`);
+
+const SCALE_CLASS = (ns) =>
+  new RegExp(`^${ns}-(?:${SPACING_KEYS.join("|")})$`);
+
+const FRACTION_CLASS = (ns) =>
+  new RegExp(`^${ns}-(?:${FRACTIONS.join("|")})$`);
+
+const SIMPLE_SET = (ns, set) =>
+  new RegExp(`^${ns}-(?:${set.join("|")})$`);
+
+const EXACT = (...names) => new RegExp(`^(?:${names.map(n=>n.replace(/[.*+?^${}()|[\\]\\\\]/g,"\\$&")).join("|")})$`);
+
+export const TAILWIND_PATTERNS = [
+  // Display & Position
+  EXACT("block","inline-block","inline","flex","inline-flex","grid","inline-grid","contents","hidden"),
+  EXACT("static","fixed","absolute","relative","sticky"),
+  // Flex & Grid
+  EXACT("flex-row","flex-row-reverse","flex-col","flex-col-reverse","flex-wrap","flex-nowrap","flex-wrap-reverse"),
+  EXACT("items-start","items-center","items-end","items-baseline","items-stretch"),
+  EXACT("justify-start","justify-center","justify-end","justify-between","justify-around","justify-evenly","content-center","content-between","content-around","content-evenly"),
+  EXACT("self-auto","self-start","self-center","self-end","self-stretch","place-content-center","place-items-center","place-self-center"),
+  // Spacing
+  SCALE_CLASS("p"), SCALE_CLASS("px"), SCALE_CLASS("py"), SCALE_CLASS("pt"), SCALE_CLASS("pr"), SCALE_CLASS("pb"), SCALE_CLASS("pl"),
+  SCALE_CLASS("m"), SCALE_CLASS("mx"), SCALE_CLASS("my"), SCALE_CLASS("mt"), SCALE_CLASS("mr"), SCALE_CLASS("mb"), SCALE_CLASS("ml"),
+  SCALE_CLASS("gap"), SCALE_CLASS("space-x"), SCALE_CLASS("space-y"),
+  // Sizing
+  SCALE_CLASS("h"), SCALE_CLASS("w"), FRACTION_CLASS("h"), FRACTION_CLASS("w"),
+  // Extended sizing utilities
+  SCALE_CLASS("min-h"), SCALE_CLASS("min-w"),
+  SCALE_CLASS("max-h"), SCALE_CLASS("max-w"),
+  SIMPLE_SET("max-w", [
+    "0","none","xs","sm","md","lg","xl","2xl","3xl","4xl","5xl","6xl","7xl",
+    "full","min","max","fit","prose",
+    "screen-sm","screen-md","screen-lg","screen-xl","screen-2xl"
+  ]),
+  SIMPLE_SET("min-h", ["0","full","screen","min","max","fit"]),
+  SIMPLE_SET("max-h", ["0","full","screen","min","max","fit"]),
+  SIMPLE_SET("min-w", ["0","full","min","max","fit"]),
+  // Typography
+  SIMPLE_SET("text", FONT_SIZES),
+  // Recognize all standard Tailwind font-size utilities (including text-md, text-base, etc.)
+  /^text-(?:xs|sm|base|md|lg|xl|2xl|3xl|4xl|5xl|6xl|7xl|8xl|9xl)$/,
+  EXACT("antialiased","subpixel-antialiased"),
+  EXACT("font-thin","font-extralight","font-light","font-normal","font-medium","font-semibold","font-bold","font-extrabold","font-black"),
+  EXACT("italic","not-italic"),
+  EXACT("uppercase","lowercase","capitalize","normal-case","truncate","break-words","break-normal"),
+  // Colors
+  COLOR_CLASS("text"), COLOR_CLASS("bg"), COLOR_CLASS("border"), COLOR_CLASS("divide"),
+  // Border radius & width & style
+  new RegExp(`^rounded(?:-(?:${RADII.join("|")}))?$`),
+  SIMPLE_SET("border", BORDER_W), EXACT("border","border-x","border-y","border-t","border-r","border-b","border-l"),
+  EXACT("border-solid","border-dashed","border-dotted","border-double","border-none"),
+  // Effects
+  EXACT("shadow","shadow-sm","shadow-md","shadow-lg","shadow-xl","shadow-2xl","shadow-inner","shadow-none"),
+  SIMPLE_SET("opacity", OPACITY),
+  // Transforms & Transitions
+  EXACT("transform","transform-gpu","transform-none"),
+  EXACT("transition","transition-none","transition-all","transition-colors","transition-opacity","transition-shadow","transition-transform"),
+  SIMPLE_SET("duration", ["75","100","150","200","300","500","700","1000"]),
+  SIMPLE_SET("delay", ["75","100","150","200","300","500","700","1000"]),
+  SIMPLE_SET("ease", ["linear","in","out","in-out"]),
+  // Layout helpers
+  EXACT("container","sr-only","not-sr-only","overflow-hidden","overflow-auto","overflow-scroll","overflow-x-hidden","overflow-y-hidden","overflow-x-auto","overflow-y-auto"),
+  // Z-index
+  SIMPLE_SET("z", ZINDEX),
+  // Cursors & pointer events
+  EXACT("pointer-events-none","pointer-events-auto","cursor-default","cursor-pointer","cursor-not-allowed"),
+  // Tables
+  EXACT("table-auto","table-fixed","border-collapse","border-separate","caption-top","caption-bottom")
+];
+
+// Arbitrary value syntax (always Tailwind, but not default-scale):
+export const ARBITRARY_RE = /-\\[(?:.|\\n)+?\\]$/;
+
+// Known base namespaces (for quick prefix sniffing)
+export const KNOWN_PREFIXES = [
+  "p","px","py","pt","pr","pb","pl",
+  "m","mx","my","mt","mr","mb","ml",
+  "text","bg","border","divide","ring","outline",
+  "rounded","grid","col","row","gap","justify","items","content","place",
+  "h","w","min-h","min-w","max-h","max-w",
+  "shadow","opacity","z","duration","delay","ease","transition",
+  "overflow","cursor","pointer-events","table","caption","container",
+];