litmus-cli 0.2.0

package/dist/lib/zip.js

@@ -0,0 +1,96 @@
+import archiver from "archiver";
+import { createWriteStream, readFileSync, existsSync } from "fs";
+import path from "path";
+import os from "os";
+// Directories always excluded from submissions.
+// NOTE: .git is intentionally NOT excluded — git history is included so the
+// analysis backend can run parse_git_history() on the submission.
+const ALWAYS_EXCLUDE = [
+    "node_modules",
+    "__pycache__",
+    "venv",
+    ".venv",
+    "env",
+    ".env",
+    "target", // Rust/Java build output
+    "build",
+    "dist",
+    ".gradle",
+    ".idea",
+    ".DS_Store",
+    "*.pyc",
+    "*.class",
+    // Legacy injected tracking files — exclude so they don't pollute submissions
+    // from assessments downloaded before the CLI-native tracking was deployed.
+    "setup.sh",
+    "tracker.py",
+    "tracker.js",
+    "heartbeat.py",
+];
+/**
+ * Create a ZIP of the project directory for submission.
+ * Respects .gitignore patterns (basic support) and excludes common large dirs.
+ * Always includes .litmus/activity.jsonl (the tracking log).
+ *
+ * @param projectDir - Root of the project to zip
+ * @returns Path to the temporary ZIP file
+ */
+export async function createSubmissionZip(projectDir) {
+    const tmpFile = path.join(os.tmpdir(), `litmus-submission-${Date.now()}.zip`);
+    const output = createWriteStream(tmpFile);
+    const archive = archiver("zip", { zlib: { level: 6 } });
+    return new Promise((resolve, reject) => {
+        output.on("close", () => resolve(tmpFile));
+        archive.on("error", reject);
+        archive.pipe(output);
+        // Compute glob patterns to ignore
+        const ignoredGlobs = buildIgnoreGlobs(projectDir);
+        // Add the project directory contents (not the directory itself)
+        archive.glob("**/*", {
+            cwd: projectDir,
+            dot: true, // Include dotfiles like .litmus/
+            ignore: ignoredGlobs,
+        });
+        archive.finalize();
+    });
+}
+function buildIgnoreGlobs(projectDir) {
+    const patterns = [];
+    // Always-excluded dirs/patterns
+    for (const excluded of ALWAYS_EXCLUDE) {
+        if (excluded.startsWith("*")) {
+            patterns.push(excluded);
+        }
+        else {
+            patterns.push(`${excluded}/**`);
+            patterns.push(`**/${excluded}/**`);
+        }
+    }
+    // Basic .gitignore support
+    const gitignorePath = path.join(projectDir, ".gitignore");
+    if (existsSync(gitignorePath)) {
+        try {
+            const lines = readFileSync(gitignorePath, "utf8")
+                .split("\n")
+                .map((l) => l.trim())
+                .filter((l) => l && !l.startsWith("#"));
+            for (const line of lines) {
+                if (line.endsWith("/")) {
+                    // Directory pattern
+                    const dir = line.slice(0, -1);
+                    patterns.push(`${dir}/**`);
+                    patterns.push(`**/${dir}/**`);
+                }
+                else {
+                    patterns.push(line);
+                    patterns.push(`**/${line}`);
+                }
+            }
+        }
+        catch {
+            // Ignore .gitignore parse errors
+        }
+    }
+    return patterns;
+}
+//# sourceMappingURL=zip.js.map

package/dist/lib/zip.js.map

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

package/dist/utils/detect-project.d.ts

@@ -0,0 +1,11 @@
+export type ProjectType = "node" | "python" | "go" | "java" | "dotnet" | "rust" | "ruby" | "php" | "unknown";
+export interface ProjectInfo {
+    type: ProjectType;
+    installCommand: string | null;
+    runHint: string | null;
+}
+/**
+ * Detect project type and suggest an install command.
+ */
+export declare function detectProject(dir: string): ProjectInfo;
+//# sourceMappingURL=detect-project.d.ts.map

package/dist/utils/detect-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-project.d.ts","sourceRoot":"","sources":["../../src/utils/detect-project.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,QAAQ,GACR,IAAI,GACJ,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,KAAK,GACL,SAAS,CAAA;AAEb,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CA2DtD"}

package/dist/utils/detect-project.js

@@ -0,0 +1,55 @@
+import { existsSync } from "fs";
+import path from "path";
+/**
+ * Detect project type and suggest an install command.
+ */
+export function detectProject(dir) {
+    if (existsSync(path.join(dir, "package.json"))) {
+        const hasYarnLock = existsSync(path.join(dir, "yarn.lock"));
+        const hasPnpmLock = existsSync(path.join(dir, "pnpm-lock.yaml"));
+        const installCommand = hasPnpmLock
+            ? "pnpm install"
+            : hasYarnLock
+                ? "yarn"
+                : "npm install";
+        return { type: "node", installCommand, runHint: "npm start / npm test" };
+    }
+    if (existsSync(path.join(dir, "requirements.txt")) ||
+        existsSync(path.join(dir, "pyproject.toml")) ||
+        existsSync(path.join(dir, "setup.py"))) {
+        // Create a venv and install into it (replaces what the old setup.sh did).
+        // Use venv/bin/pip directly so activation isn't required at install time.
+        const pipBin = process.platform === "win32" ? "venv\\Scripts\\pip" : "venv/bin/pip";
+        const installCommand = existsSync(path.join(dir, "requirements.txt"))
+            ? `python3 -m venv venv && ${pipBin} install -r requirements.txt`
+            : `python3 -m venv venv && ${pipBin} install -e .`;
+        return {
+            type: "python",
+            installCommand,
+            runHint: "source venv/bin/activate  # then: python main.py / pytest",
+        };
+    }
+    if (existsSync(path.join(dir, "go.mod"))) {
+        return { type: "go", installCommand: "go mod download", runHint: "go run . / go test ./..." };
+    }
+    if (existsSync(path.join(dir, "pom.xml"))) {
+        return { type: "java", installCommand: "mvn install", runHint: "mvn test" };
+    }
+    if (existsSync(path.join(dir, "build.gradle")) || existsSync(path.join(dir, "build.gradle.kts"))) {
+        return { type: "java", installCommand: "gradle build", runHint: "gradle test" };
+    }
+    if (existsSync(path.join(dir, "*.csproj")) || existsSync(path.join(dir, "*.sln"))) {
+        return { type: "dotnet", installCommand: "dotnet restore", runHint: "dotnet run / dotnet test" };
+    }
+    if (existsSync(path.join(dir, "Cargo.toml"))) {
+        return { type: "rust", installCommand: null, runHint: "cargo run / cargo test" };
+    }
+    if (existsSync(path.join(dir, "Gemfile"))) {
+        return { type: "ruby", installCommand: "bundle install", runHint: "ruby main.rb / rspec" };
+    }
+    if (existsSync(path.join(dir, "composer.json"))) {
+        return { type: "php", installCommand: "composer install", runHint: "php -S localhost:8000" };
+    }
+    return { type: "unknown", installCommand: null, runHint: null };
+}
+//# sourceMappingURL=detect-project.js.map

package/dist/utils/detect-project.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,19 @@
+export declare const FALLBACK_URL = "https://app.litmus.sh";
+/**
+ * Print a plain-English error and exit.
+ * Always shows a fallback URL for candidates who can't resolve the issue.
+ */
+export declare function fatal(message: string, hint?: string): never;
+/**
+ * Print a warning (non-fatal).
+ */
+export declare function warn(message: string): void;
+/**
+ * Print a success message.
+ */
+export declare function success(message: string): void;
+/**
+ * Print a plain info line.
+ */
+export declare function info(message: string): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,0BAA0B,CAAA;AAEnD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAW3D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C"}

package/dist/utils/errors.js

@@ -0,0 +1,35 @@
+import chalk from "chalk";
+export const FALLBACK_URL = "https://app.litmus.sh";
+/**
+ * Print a plain-English error and exit.
+ * Always shows a fallback URL for candidates who can't resolve the issue.
+ */
+export function fatal(message, hint) {
+    console.error();
+    console.error(chalk.red("✗ Error: ") + message);
+    if (hint) {
+        console.error(chalk.dim("  Hint: ") + hint);
+    }
+    console.error(chalk.dim(`  Need help? Visit ${FALLBACK_URL} to manage your assessment.`));
+    console.error();
+    process.exit(1);
+}
+/**
+ * Print a warning (non-fatal).
+ */
+export function warn(message) {
+    console.warn(chalk.yellow("⚠ Warning: ") + message);
+}
+/**
+ * Print a success message.
+ */
+export function success(message) {
+    console.log(chalk.green("✓ ") + message);
+}
+/**
+ * Print a plain info line.
+ */
+export function info(message) {
+    console.log(chalk.dim("  ") + message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAA;AAEnD;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,IAAa;IAClD,OAAO,CAAC,KAAK,EAAE,CAAA;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,CAAA;IAC/C,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,sBAAsB,YAAY,6BAA6B,CAAC,CAC3E,CAAA;IACD,OAAO,CAAC,KAAK,EAAE,CAAA;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,CAAA;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;AACxC,CAAC"}

package/dist/watcher.cjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * Litmus file activity watcher.
+ * Runs as a detached background process started by `litmus init`.
+ * Usage: node watcher.cjs <projectDir> <activityLogPath>
+ *
+ * Writes newline-delimited JSON to the activity log:
+ *   { "ts": "ISO-8601", "type": "add"|"change"|"unlink", "path": "relative/path" }
+ */
+
+const chokidar = require("chokidar")
+const fs = require("fs")
+const path = require("path")
+
+const [, , projectDir, activityLogPath] = process.argv
+
+if (!projectDir || !activityLogPath) {
+  process.stderr.write("Usage: node watcher.cjs <projectDir> <activityLogPath>\n")
+  process.exit(1)
+}
+
+// Ensure the log directory exists
+fs.mkdirSync(path.dirname(activityLogPath), { recursive: true })
+
+// Open the log file for appending
+const log = fs.createWriteStream(activityLogPath, { flags: "a" })
+
+function write(type, filePath) {
+  const event = JSON.stringify({
+    ts: new Date().toISOString(),
+    type,
+    path: path.relative(projectDir, filePath),
+  })
+  log.write(event + "\n")
+}
+
+const ignored = [
+  /(^|[/\\])\./,      // dotfiles and dotdirs (including .git, .litmus)
+  /node_modules/,
+  /__pycache__/,
+  /\.pyc$/,
+  /\.class$/,
+]
+
+chokidar
+  .watch(projectDir, {
+    ignored,
+    ignoreInitial: true,
+    persistent: true,
+    awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
+  })
+  .on("add", (p) => write("add", p))
+  .on("change", (p) => write("change", p))
+  .on("unlink", (p) => write("unlink", p))
+  .on("error", (err) => {
+    // Log errors but don't crash — tracking is non-critical
+    process.stderr.write(`[watcher] error: ${err}\n`)
+  })

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "litmus-cli",
+  "version": "0.2.0",
+  "description": "CLI tool for Litmus engineering assessments",
+  "license": "MIT",
+  "author": "elenazhao",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "litmus": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && cp src/lib/watcher.cjs dist/watcher.cjs",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "chalk": "^5.3.0",
+    "chokidar": "^3.6.0",
+    "commander": "^12.1.0",
+    "form-data": "^4.0.1",
+    "node-fetch": "^3.3.2",
+    "ora": "^8.1.1",
+    "unzipper": "^0.12.3"
+  },
+  "devDependencies": {
+    "@types/archiver": "^6.0.3",
+    "@types/node": "^20.0.0",
+    "@types/unzipper": "^0.10.10",
+    "typescript": "^5.4.5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/commands/init.ts

@@ -0,0 +1,171 @@
+import { createWriteStream, unlinkSync } from "fs"
+import { pipeline } from "stream/promises"
+import { Readable } from "stream"
+import path from "path"
+import os from "os"
+import chalk from "chalk"
+import ora from "ora"
+import { fetchInitMetadata, downloadZip } from "../lib/api.js"
+import { writeConfig } from "../lib/config.js"
+import { extractZip } from "../lib/extract.js"
+import { startTracker } from "../lib/tracker.js"
+import { detectProject } from "../utils/detect-project.js"
+import { fatal, success, info, warn, FALLBACK_URL } from "../utils/errors.js"
+import { execSync } from "child_process"
+
+const DEFAULT_API_BASE = process.env.LITMUS_API_URL || "https://app.litmus.sh"
+
+export async function runInit(token: string): Promise<void> {
+  const apiBase = DEFAULT_API_BASE
+
+  // Step 1: Fetch metadata
+  const spinner = ora("Connecting to Litmus...").start()
+  let metadata: Awaited<ReturnType<typeof fetchInitMetadata>>
+
+  try {
+    metadata = await fetchInitMetadata(apiBase, token)
+    spinner.succeed("Connected")
+  } catch (err) {
+    spinner.fail("Connection failed")
+    const msg = err instanceof Error ? err.message : String(err)
+    fatal(msg, `Check your token or visit ${FALLBACK_URL} to download manually.`)
+  }
+
+  // Check for naming collision
+  const targetDir = path.resolve(process.cwd(), metadata.folderName)
+  const { existsSync } = await import("fs")
+  if (existsSync(targetDir)) {
+    fatal(
+      `Folder "${metadata.folderName}" already exists in this directory.`,
+      `Delete or rename it, then run: litmus init ${token}`
+    )
+  }
+
+  // Print what we're setting up
+  console.log()
+  console.log(chalk.bold(`  ${metadata.assessmentName}`))
+  if (metadata.deadline) {
+    const deadline = new Date(metadata.deadline)
+    const hoursLeft = Math.max(
+      0,
+      Math.floor((deadline.getTime() - Date.now()) / (1000 * 60 * 60))
+    )
+    const deadlineStr = deadline.toLocaleString()
+    if (hoursLeft < 24) {
+      warn(`Deadline in ${hoursLeft} hours (${deadlineStr})`)
+    } else {
+      info(`Deadline: ${deadlineStr}`)
+    }
+  }
+  if (metadata.timeLimit) {
+    info(`Time limit: ${metadata.timeLimit} minutes`)
+  }
+  console.log()
+
+  // Step 2: Download ZIP to a temp file
+  const downloadSpinner = ora("Downloading assessment...").start()
+  const tmpZip = path.join(os.tmpdir(), `litmus-${Date.now()}.zip`)
+
+  try {
+    const zipResponse = await downloadZip(apiBase, token)
+    if (!zipResponse.body) {
+      throw new Error("Empty response from server")
+    }
+    const nodeStream = Readable.fromWeb(
+      zipResponse.body as Parameters<typeof Readable.fromWeb>[0]
+    )
+    await pipeline(nodeStream, createWriteStream(tmpZip))
+    downloadSpinner.succeed("Downloaded")
+  } catch (err) {
+    downloadSpinner.fail("Download failed")
+    const msg = err instanceof Error ? err.message : String(err)
+    fatal(msg, `Visit ${FALLBACK_URL} to download manually.`)
+  }
+
+  // Step 3: Extract from temp file to target directory
+  const extractSpinner = ora(`Setting up ${metadata.folderName}/...`).start()
+
+  try {
+    await extractZip(tmpZip, targetDir)
+    extractSpinner.succeed(`Created ${chalk.bold(metadata.folderName)}/`)
+  } catch (err) {
+    extractSpinner.fail("Extraction failed")
+    const msg = err instanceof Error ? err.message : String(err)
+    fatal(msg, `Visit ${FALLBACK_URL} to download manually.`)
+  } finally {
+    try { unlinkSync(tmpZip) } catch { /* cleanup */ }
+  }
+
+  // Step 4: Initialize git repo with initial commit
+  try {
+    execSync("git init", { cwd: targetDir, stdio: "pipe" })
+    execSync("git add -A", { cwd: targetDir, stdio: "pipe" })
+    execSync(
+      "git commit -m \"Assessment: initial state\"",
+      { cwd: targetDir, stdio: "pipe" }
+    )
+  } catch {
+    // Non-critical — git may not be installed; analysis degrades gracefully
+  }
+
+  // Step 5: Write .litmus/config.json
+  await writeConfig(targetDir, {
+    assessmentId: metadata.assessmentId,
+    assessmentName: metadata.assessmentName,
+    candidateEmail: metadata.candidateEmail,
+    candidateName: metadata.candidateName,
+    token,
+    startedAt: metadata.startedAt,
+    deadline: metadata.deadline,
+    timeLimit: metadata.timeLimit,
+    apiBase,
+  })
+
+  // Step 5: Detect project type and optionally install
+  const project = detectProject(targetDir)
+  if (project.installCommand) {
+    console.log()
+    const installSpinner = ora(
+      `Running ${chalk.cyan(project.installCommand)}... (this may take a minute)`
+    ).start()
+    try {
+      execSync(project.installCommand, {
+        cwd: targetDir,
+        stdio: "pipe",
+      })
+      installSpinner.succeed("Dependencies installed")
+    } catch {
+      installSpinner.warn(
+        `Couldn't run "${project.installCommand}" automatically. Run it manually inside ${metadata.folderName}/.`
+      )
+    }
+  }
+
+  // Step 6: Start tracker in background
+  try {
+    startTracker(targetDir)
+  } catch {
+    // Non-critical
+  }
+
+  // Done — print next steps
+  console.log()
+  success("Assessment ready")
+  console.log()
+  console.log(chalk.bold("  Next steps:"))
+  console.log()
+  console.log(`    ${chalk.cyan(`cd ${metadata.folderName}`)}`)
+  if (project.runHint) {
+    console.log(`    ${chalk.dim(`# ${project.runHint}`)}`)
+  }
+  console.log()
+  console.log(chalk.dim("  Your work is being tracked. When you're done:"))
+  console.log()
+  console.log(`    ${chalk.cyan("litmus submit")}`)
+  console.log()
+  if (metadata.deadline) {
+    const deadline = new Date(metadata.deadline)
+    console.log(chalk.dim(`  Deadline: ${deadline.toLocaleString()}`))
+    console.log()
+  }
+}

package/src/commands/submit.ts

@@ -0,0 +1,141 @@
+import { statSync, unlinkSync } from "fs"
+import path from "path"
+import chalk from "chalk"
+import ora from "ora"
+import * as readline from "readline/promises"
+import { stdin as input, stdout as output } from "process"
+import { readConfig } from "../lib/config.js"
+import { submitZip } from "../lib/api.js"
+import { createSubmissionZip } from "../lib/zip.js"
+import { fatal, success, warn, info, FALLBACK_URL } from "../utils/errors.js"
+
+export async function runSubmit(opts: { yes?: boolean }): Promise<void> {
+  // Step 1: Read config
+  const config = await readConfig()
+
+  if (!config) {
+    fatal(
+      "No Litmus assessment found in this directory.",
+      "Run this command from inside your assessment folder, or run 'litmus init <token>' first."
+    )
+  }
+
+  // Step 2: Check deadline
+  if (config.deadline) {
+    const deadline = new Date(config.deadline)
+    const now = new Date()
+
+    if (now > deadline) {
+      fatal(
+        `The submission deadline passed at ${deadline.toLocaleString()}.`,
+        `Contact the company if you need an extension. Visit ${FALLBACK_URL} for help.`
+      )
+    }
+
+    const minsLeft = Math.floor((deadline.getTime() - now.getTime()) / (1000 * 60))
+    if (minsLeft < 30) {
+      warn(`Only ${minsLeft} minutes left before the deadline!`)
+    }
+  }
+
+  // Step 3: Find the project root (where .litmus/config.json lives)
+  let projectRoot = process.cwd()
+  // readConfig walks up the tree, so we use the config's assessed location
+  // The config file is at .litmus/config.json relative to the project root
+  // We find it by searching from cwd up, same as readConfig does
+  {
+    let dir = process.cwd()
+    while (true) {
+      const configPath = path.join(dir, ".litmus", "config.json")
+      const { existsSync } = await import("fs")
+      if (existsSync(configPath)) {
+        projectRoot = dir
+        break
+      }
+      const parent = path.dirname(dir)
+      if (parent === dir) break
+      dir = parent
+    }
+  }
+
+  // Step 4: Create the submission ZIP
+  const zipSpinner = ora("Preparing submission...").start()
+  let zipPath: string
+
+  try {
+    zipPath = await createSubmissionZip(projectRoot)
+    zipSpinner.succeed("Submission prepared")
+  } catch (err) {
+    zipSpinner.fail("Failed to create submission archive")
+    const msg = err instanceof Error ? err.message : String(err)
+    fatal(msg, `Visit ${FALLBACK_URL} to submit manually.`)
+  }
+
+  // Step 5: Show what's being submitted
+  const zipSizeMb = (statSync(zipPath).size / (1024 * 1024)).toFixed(1)
+  const folderName = path.basename(projectRoot)
+
+  console.log()
+  console.log(chalk.bold(`  Submitting: ${config.assessmentName}`))
+  info(`  Archive size: ${zipSizeMb} MB`)
+  info(`  Tracking log included`)
+  if (config.deadline) {
+    info(`  Deadline: ${new Date(config.deadline).toLocaleString()}`)
+  }
+  console.log()
+
+  // Step 6: Confirm (unless --yes flag)
+  if (!opts.yes) {
+    const rl = readline.createInterface({ input, output })
+    let answer: string
+    try {
+      answer = await rl.question(
+        chalk.bold("  Confirm submission? ") + chalk.dim("[Y/n] ")
+      )
+    } finally {
+      rl.close()
+    }
+
+    const confirmed = answer.trim().toLowerCase()
+    if (confirmed !== "" && confirmed !== "y" && confirmed !== "yes") {
+      console.log()
+      console.log(chalk.dim("  Submission cancelled. Your work is saved."))
+      console.log()
+      try { unlinkSync(zipPath) } catch { /* cleanup */ }
+      process.exit(0)
+    }
+  }
+
+  console.log()
+
+  // Step 7: Upload
+  const uploadSpinner = ora("Uploading submission...").start()
+
+  try {
+    const fileName = `${folderName}_submission.zip`
+    const result = await submitZip(config.apiBase, config.token, zipPath, fileName)
+    uploadSpinner.succeed("Submission received")
+
+    console.log()
+    success("You're done!")
+    console.log()
+    console.log(
+      chalk.dim("  The company will review your work and be in touch.")
+    )
+    if (result.submissionId) {
+      console.log(chalk.dim(`  Submission ID: ${result.submissionId}`))
+    }
+    console.log()
+  } catch (err) {
+    uploadSpinner.fail("Upload failed")
+    const msg = err instanceof Error ? err.message : String(err)
+    console.log()
+    fatal(
+      msg,
+      `To submit manually, visit ${FALLBACK_URL} and upload your ZIP from there.`
+    )
+  } finally {
+    // Clean up temp ZIP
+    try { unlinkSync(zipPath) } catch { /* cleanup */ }
+  }
+}