nugit-cli 0.1.0 → 0.1.1

package/src/nugit-start.js

@@ -1,211 +0,0 @@
-import { spawn } from "child_process";
-import fs from "fs";
-import path from "path";
-import {
-  buildStartEnv,
-  expandUserPath,
-  getConfigPath,
-  inferMonorepoRootFromCli,
-  loadEnvFile,
-  mergeNugitPath,
-  readUserConfig,
-  writeUserConfig
-} from "./user-config.js";
-import { findGitRoot, parseRepoFullName } from "./nugit-stack.js";
-import { getRepoFullNameFromGitRoot } from "./git-info.js";
-import { questionLine } from "./stack-view/prompt-line.js";
-
-/**
- * @param {object} opts
- * @param {string} [opts.installRoot]
- * @param {string} [opts.envFile]
- * @param {string} [opts.workingDirectory]
- */
-export function runConfigInit(opts) {
-  const root = path.resolve(
-    expandUserPath(opts.installRoot || inferMonorepoRootFromCli())
-  );
-  const defaultEnv = path.join(root, ".env");
-  const envFile = expandUserPath(opts.envFile || defaultEnv);
-  const cfg = { installRoot: root, envFile };
-  if (opts.workingDirectory) {
-    cfg.workingDirectory = expandUserPath(opts.workingDirectory);
-  }
-  writeUserConfig(cfg);
-  console.error(`Wrote ${getConfigPath()}`);
-  console.error(`  installRoot: ${root}`);
-  console.error(`  envFile: ${envFile}`);
-  if (!fs.existsSync(envFile)) {
-    console.error(`  (env file does not exist yet — create it or run: nugit config set env-file <path>)`);
-  }
-  if (cfg.workingDirectory) {
-    console.error(`  workingDirectory: ${cfg.workingDirectory}`);
-  }
-}
-
-export function runConfigShow() {
-  const c = readUserConfig();
-  console.log(JSON.stringify(c, null, 2));
-}
-
-/**
- * @param {string} key
- * @param {string} value
- */
-export function runConfigSet(key, value) {
-  const c = readUserConfig();
-  const k = key.toLowerCase().replace(/_/g, "-");
-  if (k === "install-root") {
-    c.installRoot = path.resolve(expandUserPath(value));
-  } else if (k === "env-file") {
-    c.envFile = expandUserPath(value);
-  } else if (k === "working-directory" || k === "cwd") {
-    c.workingDirectory = expandUserPath(value);
-  } else if (k === "stack-discovery-mode") {
-    c.stackDiscovery = { ...(c.stackDiscovery || {}), mode: value };
-  } else if (k === "stack-discovery-max-open-prs") {
-    c.stackDiscovery = {
-      ...(c.stackDiscovery || {}),
-      maxOpenPrs: Number.parseInt(value, 10)
-    };
-  } else if (k === "stack-discovery-fetch-concurrency") {
-    c.stackDiscovery = {
-      ...(c.stackDiscovery || {}),
-      fetchConcurrency: Number.parseInt(value, 10)
-    };
-  } else if (k === "stack-discovery-background") {
-    c.stackDiscovery = {
-      ...(c.stackDiscovery || {}),
-      background: value === "true" || value === "1"
-    };
-  } else if (k === "stack-discovery-lazy-first-pass-max-prs") {
-    c.stackDiscovery = {
-      ...(c.stackDiscovery || {}),
-      lazyFirstPassMaxPrs: Number.parseInt(value, 10)
-    };
-  } else {
-    throw new Error(
-      `Unknown key "${key}". Use: install-root | env-file | working-directory | stack-discovery-mode | stack-discovery-max-open-prs | stack-discovery-fetch-concurrency | stack-discovery-background | stack-discovery-lazy-first-pass-max-prs`
-    );
-  }
-  writeUserConfig(c);
-  console.error(`Updated ${getConfigPath()}`);
-}
-
-/**
- * Shell-escape for single-quoted POSIX strings.
- * @param {string} s
- */
-function shellQuoteExport(s) {
-  return `'${String(s).replace(/'/g, `'\\''`)}'`;
-}
-
-/**
- * Print eval-able export lines (bash/zsh).
- * @param {'bash' | 'fish'} style
- */
-export function runEnvExport(style = "bash") {
-  const cfg = readUserConfig();
-  if (!cfg.installRoot || !cfg.envFile) {
-    throw new Error("Run `nugit config init` first (or set install-root and env-file).");
-  }
-  const root = path.resolve(expandUserPath(cfg.installRoot));
-  const { vars, pathUsed } = loadEnvFile(cfg.envFile);
-  const merged = mergeNugitPath(
-    {
-      ...process.env,
-      ...vars,
-      NUGIT_MONOREPO_ROOT: root,
-      NUGIT_ENV_FILE: pathUsed
-    },
-    root
-  );
-
-  if (style === "fish") {
-    for (const [k, v] of Object.entries(vars)) {
-      console.log(`set -gx ${k} ${JSON.stringify(v)}`);
-    }
-    console.log(`set -gx NUGIT_MONOREPO_ROOT ${JSON.stringify(root)}`);
-    console.log(`set -gx NUGIT_ENV_FILE ${JSON.stringify(pathUsed)}`);
-    if (merged.PATH && merged.PATH !== process.env.PATH) {
-      console.log(`set -gx PATH ${JSON.stringify(merged.PATH)}`);
-    }
-    return;
-  }
-
-  for (const [k, v] of Object.entries(vars)) {
-    console.log(`export ${k}=${shellQuoteExport(v)}`);
-  }
-  console.log(`export NUGIT_MONOREPO_ROOT=${shellQuoteExport(root)}`);
-  console.log(`export NUGIT_ENV_FILE=${shellQuoteExport(pathUsed)}`);
-  if (merged.PATH && merged.PATH !== process.env.PATH) {
-    console.log(`export PATH=${shellQuoteExport(merged.PATH)}`);
-  }
-}
-
-/**
- * @param {object} opts
- * @param {string} [opts.command] shell command string for -lc
- */
-export function runStart(opts) {
-  const cfg = readUserConfig();
-  if (!cfg.installRoot || !cfg.envFile) {
-    throw new Error(
-      "No saved config. Run:\n  nugit config init\n  # then: nugit start"
-    );
-  }
-  const env = buildStartEnv(cfg);
-  const cwd = cfg.workingDirectory
-    ? expandUserPath(cfg.workingDirectory)
-    : process.cwd();
-  const shell = process.env.SHELL || "/bin/bash";
-  const cmd = opts.command;
-  const args = cmd ? ["-lc", cmd] : ["-i"];
-  const child = spawn(shell, args, {
-    env,
-    cwd,
-    stdio: "inherit"
-  });
-  child.on("exit", (code, signal) => {
-    if (signal) {
-      process.exit(1);
-    }
-    process.exit(code ?? 0);
-  });
-}
-
-/**
- * Interactive menu when stdin/stdout are TTY. Options 1–2 run then exit; 3 spawns the shell (same as plain `nugit start` without a menu).
- */
-export async function runStartHub() {
-  console.error("nugit start — choose:");
-  console.error("  1) View stacks (`nugit view` — search GitHub or this directory’s remote)");
-  console.error("  2) Split a PR");
-  console.error("  3) Open shell (needs `nugit config init`)");
-  const ans = (await questionLine("Enter 1–3 [3]: ")).trim();
-  const choice = ans || "3";
-  if (choice === "1") {
-    const { runNugitViewEntry } = await import("./stack-view/run-view-entry.js");
-    await runNugitViewEntry(undefined, undefined, {});
-    process.exit(0);
-  }
-  if (choice === "2") {
-    const raw = (await questionLine("PR number to split: ")).trim();
-    const n = Number.parseInt(raw, 10);
-    if (!Number.isFinite(n) || n < 1) {
-      console.error("Invalid PR number.");
-      process.exit(1);
-    }
-    const root = findGitRoot();
-    if (!root) {
-      console.error("Not inside a git repository.");
-      process.exit(1);
-    }
-    const repoFull = getRepoFullNameFromGitRoot(root);
-    const { owner, repo: repoName } = parseRepoFullName(repoFull);
-    const { runSplitCommand } = await import("./split-view/run-split.js");
-    await runSplitCommand({ root, owner, repo: repoName, prNumber: n });
-    process.exit(0);
-  }
-  runStart({});
-}

package/src/stack-discover.js

@@ -1,292 +0,0 @@
-import { githubListOpenPulls } from "./github-rest.js";
-import { getGithubContents, decodeGithubFileContent, getPull } from "./api-client.js";
-import { validateStackDoc } from "./nugit-stack.js";
-
-/**
- * Stack tip PR # from layer.tip, else top entry by position in doc.prs.
- * @param {Record<string, unknown>} doc
- * @returns {number | null}
- */
-export function stackTipPrNumber(doc) {
-  const layer = doc.layer;
-  if (layer && typeof layer === "object") {
-    const tip = /** @type {{ tip?: { pr_number?: number } }} */ (layer).tip;
-    if (tip && typeof tip === "object" && typeof tip.pr_number === "number" && tip.pr_number >= 1) {
-      return tip.pr_number;
-    }
-  }
-  const prs = Array.isArray(doc.prs) ? doc.prs : [];
-  if (!prs.length) {
-    return null;
-  }
-  const sorted = [...prs].sort(
-    (a, b) =>
-      (/** @type {{ position?: number }} */ (a).position ?? 0) -
-      (/** @type {{ position?: number }} */ (b).position ?? 0)
-  );
-  const top = sorted[sorted.length - 1];
-  const n = top && typeof top === "object" ? /** @type {{ pr_number?: number }} */ (top).pr_number : undefined;
-  return typeof n === "number" && n >= 1 ? n : null;
-}
-
-/**
- * @param {Record<string, unknown>} doc
- * @param {string} owner
- * @param {string} repo
- */
-export function docRepoMatches(doc, owner, repo) {
-  const full = String(doc.repo_full_name || "").toLowerCase();
-  return full === `${owner}/${repo}`.toLowerCase();
-}
-
-/**
- * @template T
- * @param {T[]} items
- * @param {number} concurrency
- * @param {(item: T, index: number) => Promise<void>} fn
- */
-async function forEachPool(items, concurrency, fn) {
-  let idx = 0;
-  const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
-    for (;;) {
-      const i = idx++;
-      if (i >= items.length) {
-        return;
-      }
-      await fn(items[i], i);
-    }
-  });
-  await Promise.all(workers);
-}
-
-/**
- * @param {string} owner
- * @param {string} repo
- * @param {string} ref
- * @returns {Promise<Record<string, unknown> | null>}
- */
-async function tryLoadStackDocAtRef(owner, repo, ref) {
-  try {
-    const item = await getGithubContents(owner, repo, ".nugit/stack.json", ref);
-    const text = decodeGithubFileContent(item);
-    if (!text) {
-      return null;
-    }
-    const doc = JSON.parse(text);
-    validateStackDoc(doc);
-    if (!docRepoMatches(doc, owner, repo)) {
-      return null;
-    }
-    return /** @type {Record<string, unknown>} */ (doc);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * If this is a propagated prefix, try to load the full tip stack doc.
- * @param {string} owner
- * @param {string} repo
- * @param {Record<string, unknown>} doc
- */
-async function maybeExpandPrefixDoc(owner, repo, doc) {
-  const layer = doc.layer && typeof doc.layer === "object" ? /** @type {Record<string, unknown>} */ (doc.layer) : null;
-  if (!layer) {
-    return doc;
-  }
-  const stackSize = layer.stack_size;
-  const prs = Array.isArray(doc.prs) ? doc.prs : [];
-  const tip = layer.tip && typeof layer.tip === "object" ? /** @type {Record<string, unknown>} */ (layer.tip) : null;
-  const tipHead = tip && typeof tip.head_branch === "string" ? tip.head_branch.trim() : "";
-  if (
-    typeof stackSize !== "number" ||
-    !Number.isFinite(stackSize) ||
-    stackSize <= prs.length ||
-    !tipHead
-  ) {
-    return doc;
-  }
-  const full = await tryLoadStackDocAtRef(owner, repo, tipHead);
-  if (!full) {
-    return doc;
-  }
-  const fullPrs = Array.isArray(full.prs) ? full.prs : [];
-  return fullPrs.length > prs.length ? full : doc;
-}
-
-/**
- * Scan open PRs; any head with committed `.nugit/stack.json` counts. Deduplicate by stack tip PR # (layer.tip or top of prs).
- *
- * @param {string} owner
- * @param {string} repo
- * @param {{
- *   maxOpenPrs?: number,
- *   listPerPage?: number,
- *   enrich?: boolean,
- *   fetchConcurrency?: number,
- *   onProgress?: (msg: string) => void
- * }} [opts]
- */
-export async function discoverStacksInRepo(owner, repo, opts = {}) {
-  const maxOpenPrs = opts.maxOpenPrs ?? 500;
-  const listPerPage = Math.min(100, Math.max(1, opts.listPerPage ?? 100));
-  const fetchConc = Math.max(1, Math.min(32, opts.fetchConcurrency ?? 8));
-  const enrich = opts.enrich !== false;
-  const onProgress = typeof opts.onProgress === "function" ? opts.onProgress : null;
-
-  /** @type {unknown[]} */
-  const allPulls = [];
-  let page = 1;
-  let truncated = false;
-  for (;;) {
-    if (maxOpenPrs > 0 && allPulls.length >= maxOpenPrs) {
-      truncated = true;
-      break;
-    }
-    const pulls = await githubListOpenPulls(owner, repo, page, listPerPage);
-    if (!Array.isArray(pulls) || pulls.length === 0) {
-      break;
-    }
-    for (const p of pulls) {
-      if (maxOpenPrs > 0 && allPulls.length >= maxOpenPrs) {
-        truncated = true;
-        break;
-      }
-      allPulls.push(p);
-    }
-    if (truncated) {
-      break;
-    }
-    if (onProgress) {
-      onProgress(`listed open PRs: ${allPulls.length}`);
-    }
-    if (pulls.length < listPerPage) {
-      break;
-    }
-    page += 1;
-  }
-
-  /** @type {({ doc: Record<string, unknown>, discoveredFromPr: number, headRef: string } | null)[]} */
-  const rowSlots = Array(allPulls.length).fill(null);
-
-  let checkedHeads = 0;
-  await forEachPool(allPulls, fetchConc, async (pull, i) => {
-    const p = pull && typeof pull === "object" ? /** @type {Record<string, unknown>} */ (pull) : {};
-    const head = p.head && typeof p.head === "object" ? /** @type {Record<string, unknown>} */ (p.head) : {};
-    const ref = typeof head.ref === "string" ? head.ref : "";
-    const num = p.number;
-    if (!ref || typeof num !== "number") {
-      return;
-    }
-    const doc = await tryLoadStackDocAtRef(owner, repo, ref);
-    checkedHeads += 1;
-    if (onProgress && (checkedHeads % 10 === 0 || checkedHeads === allPulls.length)) {
-      onProgress(`checked stack.json on PR heads: ${checkedHeads}/${allPulls.length}`);
-    }
-    if (!doc) {
-      return;
-    }
-    rowSlots[i] = { doc, discoveredFromPr: num, headRef: ref };
-  });
-
-  const found = rowSlots.filter(Boolean);
-  /** @type {Map<number, { doc: Record<string, unknown>, discoveredFromPr: number, headRef: string }>} */
-  const byTip = new Map();
-
-  for (const row of found) {
-    if (!row) {
-      continue;
-    }
-    const expandedDoc = await maybeExpandPrefixDoc(owner, repo, row.doc);
-    const tip = stackTipPrNumber(expandedDoc);
-    if (tip == null) {
-      continue;
-    }
-    const prev = byTip.get(tip);
-    const score = Array.isArray(expandedDoc.prs) ? expandedDoc.prs.length : 0;
-    const prevScore = prev ? (Array.isArray(prev.doc.prs) ? prev.doc.prs.length : 0) : -1;
-    if (!prev || score > prevScore || (score === prevScore && row.discoveredFromPr === tip)) {
-      byTip.set(tip, {
-        doc: expandedDoc,
-        discoveredFromPr: row.discoveredFromPr,
-        headRef: row.headRef
-      });
-    }
-  }
-
-  const repoFull = `${owner}/${repo}`;
-  /** @type {import("./stack-discover.js").DiscoveredStack[]} */
-  const stacks = [];
-
-  for (const [tipPr, meta] of [...byTip.entries()].sort((a, b) => a[0] - b[0])) {
-    const doc = meta.doc;
-    const prs = Array.isArray(doc.prs) ? doc.prs : [];
-    const sorted = [...prs].sort(
-      (a, b) =>
-        (/** @type {{ position?: number }} */ (a).position ?? 0) -
-        (/** @type {{ position?: number }} */ (b).position ?? 0)
-    );
-
-    /** @type {{ pr_number: number, position: number, title?: string, html_url?: string, head_branch?: string }[]} */
-    let prRows = sorted.map((entry) => {
-      const e = entry && typeof entry === "object" ? /** @type {Record<string, unknown>} */ (entry) : {};
-      return {
-        pr_number: /** @type {number} */ (e.pr_number),
-        position: /** @type {number} */ (e.position),
-        head_branch: typeof e.head_branch === "string" ? e.head_branch : undefined
-      };
-    });
-
-    if (enrich) {
-      if (onProgress) {
-        onProgress(`loading PR titles for stack tip #${tipPr}`);
-      }
-      await forEachPool(prRows, fetchConc, async (row) => {
-        try {
-          const g = await getPull(owner, repo, row.pr_number);
-          row.title = typeof g.title === "string" ? g.title : undefined;
-          row.html_url = typeof g.html_url === "string" ? g.html_url : undefined;
-        } catch {
-          /* keep without title */
-        }
-      });
-    }
-
-    const tipEntry = sorted.find((e) => {
-      const o = e && typeof e === "object" ? /** @type {{ pr_number?: number }} */ (e) : {};
-      return o.pr_number === tipPr;
-    });
-    const tipObj = tipEntry && typeof tipEntry === "object" ? /** @type {Record<string, unknown>} */ (tipEntry) : {};
-    const tipHeadBranch =
-      typeof tipObj.head_branch === "string"
-        ? tipObj.head_branch
-        : meta.headRef;
-
-    const tipPull = allPulls.find((pull) => {
-      const p = pull && typeof pull === "object" ? /** @type {Record<string, unknown>} */ (pull) : {};
-      return p.number === tipPr;
-    });
-    const tipPu = tipPull && typeof tipPull === "object" ? /** @type {Record<string, unknown>} */ (tipPull) : {};
-    const tip_updated_at = typeof tipPu.updated_at === "string" ? tipPu.updated_at : "";
-
-    stacks.push({
-      tip_pr_number: tipPr,
-      created_by: String(doc.created_by || ""),
-      discovered_from_pr: meta.discoveredFromPr,
-      pr_count: prRows.length,
-      prs: prRows,
-      tip_head_branch: tipHeadBranch,
-      tip_updated_at,
-      fetch_command: `nugit stack fetch --repo ${repoFull} --ref ${tipHeadBranch}`,
-      view_command: `nugit view --repo ${repoFull} --ref ${tipHeadBranch}`
-    });
-  }
-
-  return {
-    repo_full_name: repoFull,
-    scanned_open_prs: allPulls.length,
-    open_prs_truncated: truncated,
-    stacks_found: stacks.length,
-    stacks
-  };
-}

package/src/stack-discovery-config.js

@@ -1,91 +0,0 @@
-import { readUserConfig } from "./user-config.js";
-
-/**
- * @typedef {{
- *   mode: 'eager' | 'lazy' | 'manual',
- *   maxOpenPrs: number,
- *   fetchConcurrency: number,
- *   background: boolean,
- *   lazyFirstPassMaxPrs: number
- * }} StackDiscoveryResolved
- */
-
-/**
- * Resolve stack discovery options from ~/.config/nugit/config.json and env.
- * Env overrides: NUGIT_STACK_DISCOVERY_MODE, NUGIT_STACK_DISCOVERY_MAX_OPEN_PRS, NUGIT_STACK_DISCOVERY_CONCURRENCY, NUGIT_STACK_DISCOVERY_BACKGROUND
- * @param {Partial<StackDiscoveryResolved>} [cliOverrides] CLI flags override file/env for that invocation
- * @returns {StackDiscoveryResolved}
- */
-export function getStackDiscoveryOpts(cliOverrides = {}) {
-  const cfg = readUserConfig();
-  const sd =
-    cfg.stackDiscovery && typeof cfg.stackDiscovery === "object"
-      ? /** @type {Record<string, unknown>} */ (cfg.stackDiscovery)
-      : {};
-
-  const envMode = process.env.NUGIT_STACK_DISCOVERY_MODE;
-  const modeRaw =
-    cliOverrides.mode ??
-    envMode ??
-    (typeof sd.mode === "string" ? sd.mode : "eager");
-  const mode =
-    modeRaw === "lazy" || modeRaw === "manual" || modeRaw === "eager" ? modeRaw : "eager";
-
-  const maxFromEnv = process.env.NUGIT_STACK_DISCOVERY_MAX_OPEN_PRS;
-  const maxOpenPrs =
-    cliOverrides.maxOpenPrs ??
-    (maxFromEnv != null && maxFromEnv !== ""
-      ? Number.parseInt(maxFromEnv, 10)
-      : typeof sd.maxOpenPrs === "number"
-        ? sd.maxOpenPrs
-        : mode === "lazy"
-          ? 100
-          : 500);
-
-  const concFromEnv = process.env.NUGIT_STACK_DISCOVERY_CONCURRENCY;
-  const fetchConcurrency =
-    cliOverrides.fetchConcurrency ??
-    (concFromEnv != null && concFromEnv !== ""
-      ? Number.parseInt(concFromEnv, 10)
-      : typeof sd.fetchConcurrency === "number"
-        ? sd.fetchConcurrency
-        : 8);
-
-  const bgEnv = process.env.NUGIT_STACK_DISCOVERY_BACKGROUND;
-  const background =
-    cliOverrides.background ??
-    (bgEnv === "1" || bgEnv === "true"
-      ? true
-      : bgEnv === "0" || bgEnv === "false"
-        ? false
-        : typeof sd.background === "boolean"
-          ? sd.background
-          : false);
-
-  const lazyFirst =
-    typeof sd.lazyFirstPassMaxPrs === "number" ? sd.lazyFirstPassMaxPrs : Math.min(50, maxOpenPrs || 50);
-
-  return {
-    mode,
-    maxOpenPrs: Number.isFinite(maxOpenPrs) && maxOpenPrs >= 0 ? maxOpenPrs : 500,
-    fetchConcurrency: Math.max(1, Math.min(32, Number.isFinite(fetchConcurrency) ? fetchConcurrency : 8)),
-    background,
-    lazyFirstPassMaxPrs: Math.max(1, lazyFirst)
-  };
-}
-
-/**
- * For lazy mode: first pass cap (smaller scan before optional full refresh).
- * @param {StackDiscoveryResolved} opts
- * @param {boolean} full If true, use maxOpenPrs
- * @returns {number}
- */
-export function effectiveMaxOpenPrs(opts, full) {
-  if (full || opts.mode === "eager") {
-    return opts.maxOpenPrs;
-  }
-  if (opts.mode === "manual") {
-    return opts.maxOpenPrs;
-  }
-  return Math.min(opts.lazyFirstPassMaxPrs, opts.maxOpenPrs || 100);
-}