codeproof 1.0.1 → 1.0.3

package/.env

@@ -0,0 +1 @@
+AI_API_URL = "https://api-risk-fgef.onrender.com/predict"

package/bin/codeproof.js

@@ -4,13 +4,15 @@ import { runCli } from "../commands/run.js";
 import { runReportDashboard } from "../commands/reportDashboard.js";
 import { runMoveSecret } from "../commands/moveSecret.js";
 import { runWhoAmI } from "../commands/whoami.js";
+import { runIgnore } from "../commands/ignore.js";
+import { runApply } from "../commands/apply.js";
 import { logError, logInfo } from "../utils/logger.js";
 
 const [, , command, ...args] = process.argv;
 
 async function main() {
   if (!command || command === "-h" || command === "--help") {
-    logInfo("Usage: codeproof <command>\n\nCommands:\n  init               Initialize CodeProof in a Git repository\n  run                Run CodeProof checks (stub)\n  report@dashboard   Send latest report and show dashboard link\n  move-secret        Move high-confidence secrets to .env\n  whoami             Show the local CodeProof client ID");
+    logInfo("Usage: codeproof <command>\n\nCommands:\n  init               Initialize CodeProof in a Git repository\n  run                Run CodeProof checks (stub)\n  report@dashboard   Send latest report and show dashboard link\n  move-secret        Move high-confidence secrets to .env\n  ignore             Temporarily disable commit enforcement\n  apply              Re-enable commit enforcement\n  whoami             Show the local CodeProof client ID");
     process.exit(0);
   }
 
@@ -34,6 +36,16 @@ async function main() {
     return;
   }
 
+  if (command === "ignore") {
+    await runIgnore({ args, cwd: process.cwd() });
+    return;
+  }
+
+  if (command === "apply") {
+    await runApply({ args, cwd: process.cwd() });
+    return;
+  }
+
   if (command === "whoami") {
     await runWhoAmI();
     return;

package/commands/apply.js

@@ -0,0 +1,32 @@
+import { ensureGitRepo, getGitRoot } from "../utils/git.js";
+import { logError, logInfo, logSuccess, logWarn } from "../utils/logger.js";
+import { getEnforcementState, setEnforcementState } from "../core/enforcement.js";
+
+export async function runApply({ cwd }) {
+  // Re-enable enforcement explicitly to restore pre-commit blocking.
+  ensureGitRepo(cwd);
+  const gitRoot = getGitRoot(cwd);
+
+  let current = "enabled";
+  try {
+    current = getEnforcementState(gitRoot);
+  } catch (error) {
+    logError(error?.message || "Unable to read codeproof.config.json.");
+    process.exit(1);
+  }
+
+  if (current === "enabled") {
+    logWarn("CodeProof enforcement is already enabled.");
+    return;
+  }
+
+  try {
+    setEnforcementState(gitRoot, "enabled");
+  } catch (error) {
+    logError(error?.message || "Unable to update codeproof.config.json.");
+    process.exit(1);
+  }
+
+  logSuccess("CodeProof enforcement re-enabled.");
+  logInfo("Pre-commit protection active.");
+}

package/commands/ignore.js

@@ -0,0 +1,32 @@
+import { ensureGitRepo, getGitRoot } from "../utils/git.js";
+import { logError, logInfo, logSuccess, logWarn } from "../utils/logger.js";
+import { getEnforcementState, setEnforcementState } from "../core/enforcement.js";
+
+export async function runIgnore({ cwd }) {
+  // Controlled bypass: disabling enforcement is explicit and project-scoped.
+  ensureGitRepo(cwd);
+  const gitRoot = getGitRoot(cwd);
+
+  let current = "enabled";
+  try {
+    current = getEnforcementState(gitRoot);
+  } catch (error) {
+    logError(error?.message || "Unable to read codeproof.config.json.");
+    process.exit(1);
+  }
+
+  if (current === "disabled") {
+    logWarn("CodeProof enforcement is already disabled.");
+    return;
+  }
+
+  try {
+    setEnforcementState(gitRoot, "disabled");
+  } catch (error) {
+    logError(error?.message || "Unable to update codeproof.config.json.");
+    process.exit(1);
+  }
+
+  logSuccess("CodeProof enforcement disabled.");
+  logInfo("Commits will not be blocked until `codeproof apply` is run.");
+}

package/commands/init.js

@@ -50,6 +50,7 @@ export async function runInit({ cwd }) {
       projectId: randomUUID(),
       projectType,
       scanMode: "staged",
+      enforcement: "enabled",
       features: {
         reporting: true,
         integration: false,
@@ -70,6 +71,18 @@ export async function runInit({ cwd }) {
     logSuccess("Created codeproof.config.json");
   }
 
+  try {
+    const raw = fs.readFileSync(configPath, "utf8");
+    const existing = JSON.parse(raw);
+    if (!existing.enforcement) {
+      existing.enforcement = "enabled";
+      fs.writeFileSync(configPath, JSON.stringify(existing, null, 2) + "\n", "utf8");
+      logSuccess("Added enforcement=enabled to codeproof.config.json");
+    }
+  } catch {
+    logWarn("Unable to update enforcement in codeproof.config.json.");
+  }
+
   installPreCommitHook(gitRoot);
   logSuccess("Pre-commit hook installed.");
 

package/commands/moveSecret.js

@@ -8,6 +8,7 @@ import { ensureEnvFile, readEnvKeys, appendEnvEntries } from "../utils/envManage
 import { backupFileOnce, extractSecretValueFromLine, replaceSecretInFile } from "../utils/fileRewriter.js";
 import { resolveFeatureFlags, isVerbose } from "../core/featureFlags.js";
 import { reportFeatureDisabled, warnExperimentalOnce } from "../core/safetyGuards.js";
+import { readLatestReport } from "../reporting/reportReader.js";
 
 const TEST_PATH_HINTS = [
   "test",
@@ -37,24 +38,6 @@ function isIgnoredPath(filePath, excludes) {
   return false;
 }
 
-function readLatestReport(reportPath) {
-  if (!fs.existsSync(reportPath)) {
-    return null;
-  }
-
-  const content = fs.readFileSync(reportPath, "utf8");
-  const lines = content.split(/\r?\n/).filter(Boolean);
-  if (lines.length === 0) {
-    return null;
-  }
-
-  try {
-    return JSON.parse(lines[lines.length - 1]);
-  } catch {
-    return null;
-  }
-}
-
 function confirmProceed(message) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({
@@ -73,7 +56,6 @@ export async function runMoveSecret({ cwd }) {
   // Boundary: remediation reads reports only and must not depend on analysis state.
   ensureGitRepo(cwd);
   const gitRoot = getGitRoot(cwd);
-  const reportPath = path.join(gitRoot, "codeproof-report.log");
   const configPath = path.join(gitRoot, "codeproof.config.json");
   let config = {};
   try {
@@ -92,7 +74,7 @@ export async function runMoveSecret({ cwd }) {
   }
 
   warnExperimentalOnce("Experimental feature enabled: move-secret.", logWarn);
-  const latestReport = readLatestReport(reportPath);
+  const latestReport = readLatestReport(gitRoot)?.report || null;
 
   if (!latestReport || !Array.isArray(latestReport.findings)) {
     logWarn("No reports found. Run 'codeproof run' first.");

package/commands/reportDashboard.js

@@ -37,8 +37,13 @@ export async function runReportDashboard({ cwd }) {
 
     if (!latestReport) {
       logWarn("No reports found. Run `codeproof run` first.");
-    } else {
-      const integration = config?.integration || {};
+      return;
+    }
+
+    const integration = config?.integration || {};
+    const integrationEnabled = features.integration && Boolean(integration.enabled);
+    
+    if (integrationEnabled) {
       // Integrations are fail-open: never throw on network errors.
       withFailOpenIntegration(() => {
         sendReportToServer(latestReport, {
@@ -46,10 +51,13 @@ export async function runReportDashboard({ cwd }) {
           endpointUrl: integration.endpointUrl
         });
       });
+      logInfo("Report sent to server.");
+    } else {
+      reportFeatureDisabled("Integration", verbose, logInfo);
+    }
 
-      if (latestReport?.projectId) {
-        logInfo(`View dashboard: https://dashboard.codeproof.dev/project/${latestReport.projectId}`);
-      }
+    if (latestReport?.projectId) {
+      logInfo(`View dashboard: https://dashboard.codeproof.dev/project/${latestReport.projectId}`);
     }
   } else {
     reportFeatureDisabled("Reporting", verbose, logInfo);

package/commands/run.js

@@ -1,6 +1,6 @@
 import fs from "fs";
 import path from "path";
-import { ensureGitRepo, getGitRoot, getStagedFiles } from "../utils/git.js";
+import { ensureGitRepo, getGitRoot, getStagedFiles, getRepoIdentifier, getProjectName } from "../utils/git.js";
 import { logError, logInfo, logSuccess, logWarn } from "../utils/logger.js";
 import { buildScanTargets } from "../utils/fileScanner.js";
 import { runRuleEngine } from "../engine/ruleEngine.js";
@@ -12,6 +12,7 @@ import { writeReport } from "../reporting/reportWriter.js";
 import { sendReportToServer } from "../utils/apiClient.js";
 import { resolveFeatureFlags, isVerbose } from "../core/featureFlags.js";
 import { getClientId } from "../core/identity.js";
+import { getEnforcementState } from "../core/enforcement.js";
 import {
     reportFeatureDisabled,
     warnExperimentalOnce,
@@ -36,7 +37,7 @@ function readConfig(configPath) {
     }
 }
 
-export async function runCli({ cwd }) {
+export async function runCli({ args = [], cwd }) {
     // Boundary: CLI orchestration only. Avoid importing this module in lower layers.
     logInfo("CodeProof run started.");
 
@@ -46,6 +47,20 @@ export async function runCli({ cwd }) {
     const config = readConfig(configPath);
     const features = resolveFeatureFlags(config);
     const verbose = isVerbose(config);
+    let enforcement = "enabled";
+    try {
+        enforcement = getEnforcementState(gitRoot);
+    } catch (error) {
+        logError(error?.message || "Unable to read enforcement state.");
+        process.exit(1);
+    }
+    const isPreCommit = args.includes("--precommit") || Boolean(process.env.CODEPROOF_PRECOMMIT);
+
+    if (isPreCommit && enforcement === "disabled") {
+        logWarn("CodeProof enforcement is temporarily disabled.");
+        logInfo("Commit allowed.");
+        process.exit(0);
+    }
 
     if (!config.scanMode) {
         logError("Config missing scanMode. Expected 'staged' or 'full'.");
@@ -95,7 +110,7 @@ export async function runCli({ cwd }) {
     }
 
     const aiDecisions = aiInputs.length > 0
-        ? withFailOpenAiEscalation(features.aiEscalation, () => analyze(aiInputs, projectContext))
+        ? await withFailOpenAiEscalation(features.aiEscalation, () => analyze(aiInputs, projectContext))
         : [];
     const { blockFindings, warnFindings, aiReviewed, exitCode } = mergeDecisions({
         baselineFindings: [...findings, ...escalations],
@@ -108,9 +123,13 @@ export async function runCli({ cwd }) {
             const reportId = randomUUID();
             const projectId = config.projectId || "";
             const clientId = getClientId();
+            const projectName = getProjectName(gitRoot);
+            const repoIdentifier = getRepoIdentifier(gitRoot);
             const report = buildReport({
                 projectRoot: gitRoot,
                 projectId,
+                projectName,
+                repoIdentifier,
                 clientId,
                 reportId,
                 scanMode,

package/core/enforcement.js

@@ -0,0 +1,51 @@
+import fs from "fs";
+import path from "path";
+
+const ENFORCEMENT_ENABLED = "enabled";
+const ENFORCEMENT_DISABLED = "disabled";
+
+function getConfigPath(gitRoot) {
+  return path.join(gitRoot, "codeproof.config.json");
+}
+
+function readConfig(gitRoot) {
+  const configPath = getConfigPath(gitRoot);
+  if (!fs.existsSync(configPath)) {
+    const error = new Error("Missing codeproof.config.json. Run codeproof init first.");
+    error.code = "CODEPROOF_CONFIG_MISSING";
+    throw error;
+  }
+
+  try {
+    const raw = fs.readFileSync(configPath, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    const error = new Error("Invalid codeproof.config.json. Please fix the file.");
+    error.code = "CODEPROOF_CONFIG_INVALID";
+    throw error;
+  }
+}
+
+function writeConfig(gitRoot, config) {
+  const configPath = getConfigPath(gitRoot);
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+
+export function getEnforcementState(gitRoot) {
+  const config = readConfig(gitRoot);
+  const enforcement = String(config.enforcement || ENFORCEMENT_ENABLED).toLowerCase();
+  return enforcement === ENFORCEMENT_DISABLED ? ENFORCEMENT_DISABLED : ENFORCEMENT_ENABLED;
+}
+
+export function setEnforcementState(gitRoot, nextState) {
+  const config = readConfig(gitRoot);
+  const normalized = String(nextState || "").toLowerCase();
+  const enforcement = normalized === ENFORCEMENT_DISABLED
+    ? ENFORCEMENT_DISABLED
+    : ENFORCEMENT_ENABLED;
+
+  // Security: explicit state keeps this a reversible bypass, not a silent disable.
+  const updated = { ...config, enforcement };
+  writeConfig(gitRoot, updated);
+  return enforcement;
+}

package/core/safetyGuards.js

@@ -37,13 +37,13 @@ export function withFailOpenIntegration(action) {
   }
 }
 
-export function withFailOpenAiEscalation(enabled, action) {
+export async function withFailOpenAiEscalation(enabled, action) {
   if (!enabled) {
     return [];
   }
 
   try {
-    return action();
+    return await action();
   } catch {
     // AI failures downgrade to warnings by returning no decisions.
     return [];

package/engine/aiAnalyzer.js

@@ -1,13 +1,23 @@
+import http from "http";
+import https from "https";
+import { logWarn } from "../utils/logger.js";
+
 // AI contextual analysis layer. Only low-confidence findings reach this stage.
 // Regex-first keeps the fast baseline deterministic; AI is a cautious fallback.
 
-function callModel(payload) {
-  void payload;
-  // Stubbed: No provider hardcoded. Return null to trigger safe fallback.
-  return null;
+const DEFAULT_TIMEOUT_MS = 5000;
+
+function getAiConfig() {
+  const apiUrl = process.env.AI_API_URL || "";
+  const timeoutMs = Number(process.env.AI_TIMEOUT_MS) || DEFAULT_TIMEOUT_MS;
+  return { apiUrl, timeoutMs };
 }
 
-function fallbackDecision(finding) {
+function fallbackDecision(finding, reason) {
+  if (reason) {
+    logWarn(`AI escalation failed: ${reason}`);
+  }
+
   return {
     findingId: finding.findingId,
     verdict: "warn",
@@ -17,33 +27,115 @@ function fallbackDecision(finding) {
   };
 }
 
-export function analyze(findings, projectContext) {
-  const payload = {
-    version: 1,
-    projectContext,
-    findings: findings.map((finding) => ({
-      findingId: finding.findingId,
-      ruleId: finding.ruleId,
-      filePath: finding.filePath,
-      fileType: finding.fileType,
-      isTestLike: finding.isTestLike,
-      snippet: finding.snippet
-    }))
+function postJsonWithTimeout({ url, payload, timeoutMs }) {
+  return new Promise((resolve, reject) => {
+    let parsedUrl;
+    try {
+      parsedUrl = new URL(url);
+    } catch {
+      reject(new Error("Invalid AI_API_URL"));
+      return;
+    }
+
+    const data = JSON.stringify(payload);
+    const transport = parsedUrl.protocol === "http:" ? http : https;
+
+    const request = transport.request(
+      {
+        method: "POST",
+        hostname: parsedUrl.hostname,
+        port: parsedUrl.port || (parsedUrl.protocol === "http:" ? 80 : 443),
+        path: `${parsedUrl.pathname}${parsedUrl.search}`,
+        headers: {
+          "Content-Type": "application/json",
+          "Content-Length": Buffer.byteLength(data)
+        },
+        timeout: timeoutMs
+      },
+      (res) => {
+        let body = "";
+        res.setEncoding("utf8");
+        res.on("data", (chunk) => {
+          body += chunk;
+        });
+        res.on("end", () => {
+          if (res.statusCode && res.statusCode >= 400) {
+            reject(new Error(`AI API responded with ${res.statusCode}`));
+            return;
+          }
+          try {
+            resolve(JSON.parse(body));
+          } catch {
+            reject(new Error("AI API returned invalid JSON"));
+          }
+        });
+      }
+    );
+
+    request.on("timeout", () => {
+      request.destroy(new Error("AI request timed out"));
+    });
+
+    request.on("error", (err) => {
+      reject(err);
+    });
+
+    request.write(data);
+    request.end();
+  });
+}
+
+async function callModel(finding) {
+  const { apiUrl, timeoutMs } = getAiConfig();
+
+  if (!apiUrl) {
+    throw new Error("AI_API_URL is not configured");
+  }
+
+  const response = await postJsonWithTimeout({
+    url: apiUrl,
+    timeoutMs,
+    payload: {
+      code: finding.snippet || ""
+    }
+  });
+
+  if (!response || typeof response.found !== "boolean") {
+    throw new Error("AI API returned invalid payload");
+  }
+
+  const verdict = response.found && response.risk === "Critical" ? "block" : "warn";
+  const confidence = response.found ? 0.85 : 0.35;
+  const explanation = response.found
+    ? `AI detected ${response.risk} risk: ${response.secret || "secret value"}`
+    : "AI did not detect risk in this code snippet.";
+
+  return {
+    findingId: finding.findingId,
+    verdict,
+    confidence,
+    explanation,
+    suggestedFix: response.found ? "Move secrets to environment variables." : undefined
   };
+}
 
-  const response = callModel(payload);
+export async function analyze(findings, projectContext) {
+  void projectContext;
 
-  if (!response || !Array.isArray(response.decisions)) {
-    return findings.map(fallbackDecision);
+  if (!Array.isArray(findings) || findings.length === 0) {
+    return [];
   }
 
-  return response.decisions.map((decision) => ({
-    findingId: decision.findingId,
-    verdict: decision.verdict || "warn",
-    confidence: typeof decision.confidence === "number" ? decision.confidence : 0.5,
-    explanation: decision.explanation || "AI decision provided.",
-    suggestedFix: decision.suggestedFix
-  }));
+  return Promise.all(
+    findings.map(async (finding) => {
+      try {
+        return await callModel(finding);
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : "AI call failed";
+        return fallbackDecision(finding, reason);
+      }
+    })
+  );
 }
 
 

package/hooks/preCommit.js

@@ -12,7 +12,20 @@ function getHookBlock() {
   return [
     "",
     HOOK_MARKER,
-    "codeproof run",
+    "GIT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)",
+    "if [ -n \"$GIT_ROOT\" ]; then",
+    "  cd \"$GIT_ROOT\" || exit 1",
+    "fi",
+    "CONFIG_PATH=\"$GIT_ROOT/codeproof.config.json\"",
+    "if [ -f \"$CONFIG_PATH\" ]; then",
+    "  ENFORCEMENT=$(node -e \"const fs=require('fs');const path=process.argv[1];try{const c=JSON.parse(fs.readFileSync(path,'utf8'));console.log((c.enforcement||'enabled').toLowerCase());}catch(e){console.log('enabled');}\" \"$CONFIG_PATH\")",
+    "  if [ \"$ENFORCEMENT\" = \"disabled\" ]; then",
+    "    echo \"CodeProof enforcement is temporarily disabled.\"",
+    "    echo \"Commit allowed.\"",
+    "    exit 0",
+    "  fi",
+    "fi",
+    "CODEPROOF_PRECOMMIT=1 codeproof run --precommit",
     "RESULT=$?",
     "if [ $RESULT -ne 0 ]; then",
     "  echo \"CodeProof checks failed. Commit blocked.\"",
@@ -36,7 +49,20 @@ export function installPreCommitHook(gitRoot) {
       "#!/bin/sh",
       "", 
       "# Auto-generated by CodeProof",
-      "codeproof run",
+      "GIT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)",
+      "if [ -n \"$GIT_ROOT\" ]; then",
+      "  cd \"$GIT_ROOT\" || exit 1",
+      "fi",
+      "CONFIG_PATH=\"$GIT_ROOT/codeproof.config.json\"",
+      "if [ -f \"$CONFIG_PATH\" ]; then",
+      "  ENFORCEMENT=$(node -e \"const fs=require('fs');const path=process.argv[1];try{const c=JSON.parse(fs.readFileSync(path,'utf8'));console.log((c.enforcement||'enabled').toLowerCase());}catch(e){console.log('enabled');}\" \"$CONFIG_PATH\")",
+      "  if [ \"$ENFORCEMENT\" = \"disabled\" ]; then",
+      "    echo \"CodeProof enforcement is temporarily disabled.\"",
+      "    echo \"Commit allowed.\"",
+      "    exit 0",
+      "  fi",
+      "fi",
+      "CODEPROOF_PRECOMMIT=1 codeproof run --precommit",
       "RESULT=$?",
       "if [ $RESULT -ne 0 ]; then",
       "  echo \"CodeProof checks failed. Commit blocked.\"",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeproof",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CodeProof CLI",
   "type": "module",
   "bin": {

package/reporting/reportBuilder.js

@@ -46,6 +46,8 @@ function normalizeSeverity(value) {
 export function buildReport({
   projectRoot,
   projectId,
+  projectName,
+  repoIdentifier,
   clientId,
   reportId,
   scanMode,
@@ -85,17 +87,24 @@ export function buildReport({
       ? "allowed_with_warnings"
       : "allowed";
 
+  // Server-compatible format
   return {
-    reportId,
-    timestamp,
     projectId,
     clientId,
-    scanMode,
-    summary: {
-      totalFilesScanned: filesScannedCount,
-      totalFindings: findings.length,
-      blocksCount,
-      warningsCount
+    project: {
+      name: projectName || "Unknown Project",
+      repoIdentifier: repoIdentifier || projectRoot
+    },
+    report: {
+      timestamp,
+      scanMode,
+      summary: {
+        filesScanned: filesScannedCount,
+        findings: findings.length,
+        blocks: blocksCount,
+        warnings: warningsCount,
+        finalVerdict
+      }
     },
     findings,
     finalVerdict

package/reporting/reportWriter.js

@@ -44,6 +44,22 @@ export function writeReport({ projectRoot, report }) {
   const reportDir = getReportDir(projectRoot);
   ensureReportDir(reportDir);
 
+  // Cleanup old temp files before creating new ones
+  try {
+    const files = fs.readdirSync(reportDir);
+    for (const file of files) {
+      if (file.startsWith('.tmp-')) {
+        try {
+          fs.unlinkSync(path.join(reportDir, file));
+        } catch {
+          // Ignore errors on cleanup
+        }
+      }
+    }
+  } catch {
+    // Ignore cleanup errors
+  }
+
   // Per-run JSON keeps every audit entry immutable and easy to archive.
   let reportNumber = getNextReportNumber(reportDir);
   let reportPath = path.join(reportDir, `${REPORT_PREFIX}${reportNumber}${REPORT_SUFFIX}`);
@@ -55,8 +71,21 @@ export function writeReport({ projectRoot, report }) {
   // Use numeric sequencing over timestamps to avoid collisions in fast CI runs.
   const tempPath = path.join(reportDir, `.tmp-${process.pid}-${Date.now()}.json`);
   const payload = JSON.stringify(report, null, 2) + "\n";
-  fs.writeFileSync(tempPath, payload, "utf8");
-  fs.renameSync(tempPath, reportPath);
+  
+  try {
+    fs.writeFileSync(tempPath, payload, "utf8");
+    fs.renameSync(tempPath, reportPath);
+  } catch (err) {
+    // Cleanup temp file on error
+    try {
+      if (fs.existsSync(tempPath)) {
+        fs.unlinkSync(tempPath);
+      }
+    } catch {
+      // Ignore cleanup errors
+    }
+    throw err;
+  }
 
   return reportPath;
 }

package/utils/git.js

@@ -44,3 +44,20 @@ export function getStagedFiles(cwd) {
         .map((line) => line.trim())
         .filter(Boolean);
 }
+
+export function getRepoIdentifier(gitRoot) {
+    try {
+        const result = runGit(["config", "--get", "remote.origin.url"], gitRoot);
+        if (result.status === 0) {
+            return String(result.stdout).trim() || gitRoot;
+        }
+    } catch {
+        // Fallback to directory name
+    }
+    return gitRoot;
+}
+
+export function getProjectName(gitRoot) {
+    const parts = gitRoot.split(/[\\/]/);
+    return parts[parts.length - 1] || "Unknown";
+}