nova-link-cli 1.0.0

package/bin/nova-link.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require("../src/cli").run();

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "nova-link-cli",
+  "version": "1.0.0",
+  "description": "Terminal companion for nova-link — log in, pick a project, and push/pull code or open pull requests, all from the command line.",
+  "bin": {
+    "nova-link": "./bin/nova-link.js"
+  },
+  "type": "commonjs",
+  "license": "MIT",
+  "keywords": ["nova-link", "cli", "push", "pull-request", "git-like"],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "yargs": "^17.7.2",
+    "chalk": "^4.1.2",
+    "fs-extra": "^11.2.0",
+    "tar": "^6.2.1"
+  }
+}

package/src/activeProject.js

@@ -0,0 +1,43 @@
+const chalk = require("chalk");
+const { request } = require("./api");
+const { loadConfig, saveConfig } = require("./config");
+const { ask } = require("./prompt");
+
+// Shown right after login/signup, and by `nova-link use`. Lets the person
+// pick which project subsequent push/pull/pr commands should target.
+async function chooseActiveProject() {
+  const { projects } = await request("/projects");
+
+  if (projects.length === 0) {
+    console.log(chalk.dim("You don't have any projects yet — ask a project owner to add you, then run `nova-link use <slug>`."));
+    return;
+  }
+
+  console.log("\nYour projects:");
+  projects.forEach((p, i) => console.log(`  ${i + 1}. ${p.name}  ${chalk.dim(p.slug)}`));
+
+  const answer = await ask(`\nPick a project (1-${projects.length}): `);
+  const index = parseInt(answer, 10) - 1;
+  const chosen = projects[index];
+
+  if (!chosen) {
+    console.log(chalk.yellow("No project selected. Run `nova-link use <slug>` any time to set one."));
+    return;
+  }
+
+  const cfg = loadConfig();
+  saveConfig({ ...cfg, activeProjectId: chosen._id, activeProjectSlug: chosen.slug });
+  console.log(chalk.green(`Active project: ${chosen.slug}`));
+}
+
+// Every push/pull/pr command needs this — fails loudly if nothing is active
+// yet, rather than silently doing nothing.
+function requireActiveProject() {
+  const cfg = loadConfig();
+  if (!cfg?.activeProjectId) {
+    throw new Error("No active project. Run `nova-link use <slug>` first (see `nova-link projects` for your options).");
+  }
+  return { id: cfg.activeProjectId, slug: cfg.activeProjectSlug };
+}
+
+module.exports = { chooseActiveProject, requireActiveProject };

package/src/api.js

@@ -0,0 +1,34 @@
+const { loadConfig } = require("./config");
+
+function apiUrl() {
+  // Defaults to the deployed backend so `npm install -g nova-link-cli`
+  // works immediately for anyone, with no setup — override with
+  // NOVA_LINK_API_URL if you're pointing at a different instance (e.g. local dev).
+  return process.env.NOVA_LINK_API_URL || loadConfig()?.apiUrl || "https://backend-lmtu.onrender.com";
+}
+
+async function request(path, { method = "GET", body, auth = true } = {}) {
+  const headers = { "Content-Type": "application/json" };
+
+  if (auth) {
+    const cfg = loadConfig();
+    if (!cfg?.accessToken) {
+      throw new Error("Not logged in. Run `nova-link login` first.");
+    }
+    headers.Authorization = `Bearer ${cfg.accessToken}`;
+  }
+
+  const res = await fetch(`${apiUrl()}${path}`, {
+    method,
+    headers,
+    body: body ? JSON.stringify(body) : undefined,
+  });
+
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    throw new Error(data.error || `Request failed (${res.status})`);
+  }
+  return data;
+}
+
+module.exports = { request, apiUrl };

package/src/cli.js

@@ -0,0 +1,30 @@
+const yargs = require("yargs/yargs");
+const { hideBin } = require("yargs/helpers");
+
+const login = require("./commands/login");
+const signup = require("./commands/signup");
+const { logout, whoami } = require("./commands/session");
+const projects = require("./commands/projects");
+const use = require("./commands/use");
+const push = require("./commands/push");
+const pull = require("./commands/pull");
+const pr = require("./commands/pr");
+
+function run() {
+  yargs(hideBin(process.argv))
+    .scriptName("nova-link")
+    .command(login)
+    .command(signup)
+    .command(logout)
+    .command(whoami)
+    .command(projects)
+    .command(use)
+    .command(push)
+    .command(pull)
+    .command(pr)
+    .demandCommand(1, "Run `nova-link --help` to see available commands.")
+    .strict()
+    .help().argv;
+}
+
+module.exports = { run };

package/src/commands/login.js

@@ -0,0 +1,39 @@
+const chalk = require("chalk");
+const { request, apiUrl } = require("../api");
+const { saveConfig } = require("../config");
+const { ask } = require("../prompt");
+const { chooseActiveProject } = require("../activeProject");
+
+module.exports = {
+  command: "login",
+  describe: "Log in and pick which project you're working on",
+  builder: (yargs) =>
+    yargs
+      .option("username", { alias: "u", type: "string", describe: "Email or username" })
+      .option("password", { alias: "p", type: "string", describe: "Password" }),
+  handler: async (argv) => {
+    try {
+      const username = argv.username || (await ask("Email or username: "));
+      const password = argv.password || (await ask("Password: "));
+
+      const data = await request("/auth/cli-login", {
+        method: "POST",
+        auth: false,
+        body: { emailOrUsername: username, password },
+      });
+
+      saveConfig({
+        accessToken: data.accessToken,
+        refreshToken: data.refreshToken,
+        username: data.username,
+        apiUrl: apiUrl(),
+      });
+
+      console.log(chalk.green(`Logged in as ${data.username}.`));
+      await chooseActiveProject();
+    } catch (err) {
+      console.error(chalk.red(err.message));
+      process.exitCode = 1;
+    }
+  },
+};

package/src/commands/pr.js

@@ -0,0 +1,97 @@
+const chalk = require("chalk");
+const { request } = require("../api");
+const { requireActiveProject } = require("../activeProject");
+const { packDirectory } = require("../repoUtils");
+
+async function create(argv) {
+  try {
+    const project = requireActiveProject();
+
+    console.log(chalk.dim(`Checking permission on ${project.slug} and packing directory...`));
+    const [{ uploadUrl, archiveKey }, archive] = await Promise.all([
+      request(`/projects/${project.id}/pull-requests/init`, { method: "POST" }),
+      packDirectory(),
+    ]);
+
+    console.log(chalk.dim("Uploading to S3..."));
+    const uploadRes = await fetch(uploadUrl, {
+      method: "PUT",
+      headers: { "Content-Type": "application/gzip" },
+      body: archive,
+    });
+    if (!uploadRes.ok) {
+      throw new Error(`Upload to S3 failed (${uploadRes.status}). Check the backend's AWS credentials and bucket permissions.`);
+    }
+
+    const { pullRequest } = await request(`/projects/${project.id}/pull-requests/finalize`, {
+      method: "POST",
+      body: { message: argv.message, archiveKey },
+    });
+
+    console.log(chalk.green(`Pull request opened on ${project.slug}: ${pullRequest._id}`));
+    console.log(chalk.dim("A maintainer can accept it with `nova-link pr accept <id>`."));
+  } catch (err) {
+    console.error(chalk.red(err.message));
+    process.exitCode = 1;
+  }
+}
+
+async function list() {
+  try {
+    const project = requireActiveProject();
+    const { pullRequests } = await request(`/projects/${project.id}/pull-requests`);
+
+    if (pullRequests.length === 0) {
+      console.log(chalk.dim(`No pull requests on ${project.slug}.`));
+      return;
+    }
+    pullRequests.forEach((pr) => {
+      const statusColor = pr.status === "OPEN" ? chalk.yellow : pr.status === "MERGED" ? chalk.green : chalk.dim;
+      console.log(`${chalk.bold(pr._id)}  ${statusColor(pr.status)}  ${chalk.dim(pr.author?.username)}  ${pr.message}`);
+    });
+  } catch (err) {
+    console.error(chalk.red(err.message));
+    process.exitCode = 1;
+  }
+}
+
+async function accept(argv) {
+  try {
+    const project = requireActiveProject();
+    const { commit } = await request(`/projects/${project.id}/pull-requests/${argv.id}/accept`, { method: "POST" });
+    console.log(chalk.green(`Merged into ${project.slug}. New commit: ${commit._id}`));
+    console.log(chalk.dim("Run `nova-link pull` to get the merged code."));
+  } catch (err) {
+    console.error(chalk.red(err.message));
+    process.exitCode = 1;
+  }
+}
+
+async function reject(argv) {
+  try {
+    const project = requireActiveProject();
+    await request(`/projects/${project.id}/pull-requests/${argv.id}/reject`, { method: "POST" });
+    console.log(chalk.yellow("Pull request rejected."));
+  } catch (err) {
+    console.error(chalk.red(err.message));
+    process.exitCode = 1;
+  }
+}
+
+module.exports = {
+  command: "pr",
+  describe: "Manage pull requests on your active project",
+  builder: (yargs) =>
+    yargs
+      .command({
+        command: "create",
+        describe: "Open a pull request (contributor+)",
+        builder: (y) => y.option("message", { alias: "m", type: "string", default: "Update" }),
+        handler: create,
+      })
+      .command({ command: "list", describe: "List pull requests", handler: list })
+      .command({ command: "accept <id>", describe: "Accept and merge (maintainer/owner)", handler: accept })
+      .command({ command: "reject <id>", describe: "Reject (maintainer/owner)", handler: reject })
+      .demandCommand(1, "Specify a pr subcommand: create, list, accept, or reject."),
+  handler: () => {},
+};

package/src/commands/projects.js

@@ -0,0 +1,22 @@
+const chalk = require("chalk");
+const { request } = require("../api");
+
+module.exports = {
+  command: "projects",
+  describe: "List your projects",
+  handler: async () => {
+    try {
+      const { projects } = await request("/projects");
+      if (projects.length === 0) {
+        console.log(chalk.dim("No projects yet — create one from the web app."));
+        return;
+      }
+      projects.forEach((p) => {
+        console.log(`${chalk.bold(p.name)}  ${chalk.dim(p.slug)}  ${chalk.dim(p.visibility)}`);
+      });
+    } catch (err) {
+      console.error(chalk.red(err.message));
+      process.exitCode = 1;
+    }
+  },
+};

package/src/commands/pull.js

@@ -0,0 +1,26 @@
+const chalk = require("chalk");
+const { request } = require("../api");
+const { requireActiveProject } = require("../activeProject");
+const { unpackArchive } = require("../repoUtils");
+
+module.exports = {
+  command: "pull",
+  describe: "Fetch your active project's latest push into the current directory (overwrites local files)",
+  handler: async () => {
+    try {
+      const project = requireActiveProject();
+      const { commit } = await request(`/projects/${project.id}/commits/latest`);
+
+      console.log(chalk.dim("Downloading from S3..."));
+      const downloadRes = await fetch(commit.downloadUrl);
+      if (!downloadRes.ok) throw new Error(`Download from S3 failed (${downloadRes.status}).`);
+      const buffer = Buffer.from(await downloadRes.arrayBuffer());
+
+      await unpackArchive(buffer, process.cwd());
+      console.log(chalk.green(`Pulled ${project.slug} commit ${commit._id}: ${commit.message}`));
+    } catch (err) {
+      console.error(chalk.red(err.message));
+      process.exitCode = 1;
+    }
+  },
+};

package/src/commands/push.js

@@ -0,0 +1,41 @@
+const chalk = require("chalk");
+const { request } = require("../api");
+const { requireActiveProject } = require("../activeProject");
+const { packDirectory } = require("../repoUtils");
+
+module.exports = {
+  command: "push",
+  describe: "Push the current directory to your active project (maintainer/owner only — contributors use `nova-link pr create`)",
+  builder: (yargs) => yargs.option("message", { alias: "m", type: "string", default: "Update" }),
+  handler: async (argv) => {
+    try {
+      const project = requireActiveProject();
+
+      console.log(chalk.dim(`Checking permission on ${project.slug} and packing directory...`));
+      const [{ uploadUrl, archiveKey }, archive] = await Promise.all([
+        request(`/projects/${project.id}/commits/init`, { method: "POST" }),
+        packDirectory(),
+      ]);
+
+      console.log(chalk.dim("Uploading to S3..."));
+      const uploadRes = await fetch(uploadUrl, {
+        method: "PUT",
+        headers: { "Content-Type": "application/gzip" },
+        body: archive,
+      });
+      if (!uploadRes.ok) {
+        throw new Error(`Upload to S3 failed (${uploadRes.status}). Check the backend's AWS credentials and bucket permissions.`);
+      }
+
+      const { commit } = await request(`/projects/${project.id}/commits/finalize`, {
+        method: "POST",
+        body: { message: argv.message, archiveKey },
+      });
+
+      console.log(chalk.green(`Pushed to ${project.slug}. New commit: ${commit._id}`));
+    } catch (err) {
+      console.error(chalk.red(err.message));
+      process.exitCode = 1;
+    }
+  },
+};

package/src/commands/session.js

@@ -0,0 +1,31 @@
+const chalk = require("chalk");
+const { loadConfig, clearConfig } = require("../config");
+
+const logout = {
+  command: "logout",
+  describe: "Forget your saved login on this machine",
+  handler: () => {
+    clearConfig();
+    console.log(chalk.green("Logged out."));
+  },
+};
+
+const whoami = {
+  command: "whoami",
+  describe: "Show who you're logged in as and your active project",
+  handler: () => {
+    const cfg = loadConfig();
+    if (!cfg?.username) {
+      console.log(chalk.yellow("Not logged in. Run `nova-link login`."));
+      return;
+    }
+    console.log(`${chalk.bold(cfg.username)}  ${chalk.dim(cfg.apiUrl)}`);
+    console.log(
+      cfg.activeProjectSlug
+        ? `Active project: ${chalk.bold(cfg.activeProjectSlug)}`
+        : chalk.dim("No active project — run `nova-link use <slug>`.")
+    );
+  },
+};
+
+module.exports = { logout, whoami };

package/src/commands/signup.js

@@ -0,0 +1,41 @@
+const chalk = require("chalk");
+const { request, apiUrl } = require("../api");
+const { saveConfig } = require("../config");
+const { ask } = require("../prompt");
+const { chooseActiveProject } = require("../activeProject");
+
+module.exports = {
+  command: "signup",
+  describe: "Create a new account from the terminal",
+  builder: (yargs) =>
+    yargs
+      .option("username", { alias: "u", type: "string" })
+      .option("email", { alias: "e", type: "string" })
+      .option("password", { alias: "p", type: "string" }),
+  handler: async (argv) => {
+    try {
+      const username = argv.username || (await ask("Username: "));
+      const email = argv.email || (await ask("Email: "));
+      const password = argv.password || (await ask("Password: "));
+
+      const data = await request("/auth/signup", {
+        method: "POST",
+        auth: false,
+        body: { username, email, password },
+      });
+
+      saveConfig({
+        accessToken: data.accessToken,
+        refreshToken: data.refreshToken,
+        username: data.user.username,
+        apiUrl: apiUrl(),
+      });
+
+      console.log(chalk.green(`Account created. Logged in as ${data.user.username}.`));
+      await chooseActiveProject();
+    } catch (err) {
+      console.error(chalk.red(err.message));
+      process.exitCode = 1;
+    }
+  },
+};

package/src/commands/use.js

@@ -0,0 +1,25 @@
+const chalk = require("chalk");
+const { request } = require("../api");
+const { loadConfig, saveConfig } = require("../config");
+
+module.exports = {
+  command: "use <projectSlug>",
+  describe: "Switch which project push/pull/pr act on",
+  builder: (yargs) => yargs.positional("projectSlug", { type: "string" }),
+  handler: async (argv) => {
+    try {
+      const { projects } = await request("/projects");
+      const project = projects.find((p) => p.slug === argv.projectSlug);
+      if (!project) {
+        throw new Error(`No project found with slug "${argv.projectSlug}". Run \`nova-link projects\` to see your options.`);
+      }
+
+      const cfg = loadConfig();
+      saveConfig({ ...cfg, activeProjectId: project._id, activeProjectSlug: project.slug });
+      console.log(chalk.green(`Active project: ${project.slug}`));
+    } catch (err) {
+      console.error(chalk.red(err.message));
+      process.exitCode = 1;
+    }
+  },
+};

package/src/config.js

@@ -0,0 +1,25 @@
+const os = require("os");
+const path = require("path");
+const fs = require("fs-extra");
+
+const CONFIG_DIR = path.join(os.homedir(), ".nova-link");
+const CONFIG_PATH = path.join(CONFIG_DIR, "config.json");
+
+function loadConfig() {
+  try {
+    return fs.readJsonSync(CONFIG_PATH);
+  } catch (err) {
+    return null;
+  }
+}
+
+function saveConfig(data) {
+  fs.ensureDirSync(CONFIG_DIR);
+  fs.writeJsonSync(CONFIG_PATH, data, { spaces: 2 });
+}
+
+function clearConfig() {
+  fs.removeSync(CONFIG_PATH);
+}
+
+module.exports = { loadConfig, saveConfig, clearConfig, CONFIG_PATH };

package/src/prompt.js

@@ -0,0 +1,13 @@
+const readline = require("readline");
+
+function ask(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+}
+
+module.exports = { ask };

package/src/repoUtils.js

@@ -0,0 +1,30 @@
+const fs = require("fs-extra");
+const tar = require("tar");
+const { Readable } = require("stream");
+
+const EXCLUDES = new Set(["node_modules", ".git", ".nova-link"]);
+
+// Gzipped tarball of everything in `dir` except the excluded set above.
+async function packDirectory(dir = process.cwd()) {
+  const entries = fs.readdirSync(dir).filter((name) => !EXCLUDES.has(name));
+  const chunks = [];
+  await new Promise((resolve, reject) => {
+    const stream = tar.create({ gzip: true, cwd: dir }, entries);
+    stream.on("data", (chunk) => chunks.push(chunk));
+    stream.on("end", resolve);
+    stream.on("error", reject);
+  });
+  return Buffer.concat(chunks);
+}
+
+async function unpackArchive(buffer, destDir) {
+  fs.ensureDirSync(destDir);
+  await new Promise((resolve, reject) => {
+    Readable.from(buffer)
+      .pipe(tar.extract({ cwd: destDir }))
+      .on("finish", resolve)
+      .on("error", reject);
+  });
+}
+
+module.exports = { packDirectory, unpackArchive };