@h1veframework/cli 0.5.2 → 0.6.0

package/dist/index.js

@@ -50,6 +50,24 @@ async function createBranch(name, runner = defaultGitRunner) {
     throw new Error("GIT_BRANCH_FAILED");
   }
 }
+async function switchBranch(name, runner = defaultGitRunner) {
+  try {
+    await runner(["switch", name]);
+  } catch (err) {
+    const text = gitErrText(err);
+    if (/not a git repository/i.test(text)) throw new Error("NOT_A_GIT_REPO");
+    throw new Error("GIT_SWITCH_FAILED");
+  }
+}
+async function listLocalBranches(runner = defaultGitRunner) {
+  let out;
+  try {
+    out = await runner(["for-each-ref", "--format=%(refname:short)", "refs/heads"]);
+  } catch {
+    return [];
+  }
+  return out.split("\n").map((l) => l.trim()).filter(Boolean);
+}
 
 // ../core/src/client.ts
 var NexusApiError = class extends Error {
@@ -472,16 +490,17 @@ function formatBlocker(r) {
   return `\u2713 Blocker aberto: ${r.description}`;
 }
 function formatStartList(list) {
-  const header = "Features atribu\xEDdas a iniciar \u2014 escolha: nf start <n\xBA>";
-  const rows = list.map(
-    (f, i) => `  ${String(i + 1).padStart(2)}. ${f.name}  [${stageLabel(f.stage)}]`
-  );
+  const header = "Features para iniciar ou retomar \u2014 escolha: nf start <n\xBA>";
+  const rows = list.map((f, i) => {
+    const tag = f.branch_slug !== null ? "  (retomar)" : "";
+    return `  ${String(i + 1).padStart(2)}. ${f.name}  [${stageLabel(f.stage)}]${tag}`;
+  });
   return [header, ...rows].join("\n");
 }
-function formatStart(r) {
+function formatStart(r, opts) {
   return [
-    `\u2713 Iniciada: ${r.feature.name}`,
-    `Branch:  ${r.branch_name}  (criada e ativa)`,
+    `\u2713 ${opts?.resumed ? "Retomada" : "Iniciada"}: ${r.feature.name}`,
+    `Branch:  ${r.branch_name}  (${opts?.resumed ? "pronta e ativa" : "criada e ativa"})`,
     "Pr\xF3ximo: codar \u2192 'nf status' \u2192 'nf done' (move dev \u2192 pr)"
   ].join("\n");
 }
@@ -603,8 +622,15 @@ async function health(io) {
 }
 
 // src/commands/start.ts
-function startable(features) {
-  return features.filter((f) => f.branch_slug === null && f.stage !== "main");
+function branchSlugOf(branch) {
+  return branch.match(/^feat\/[^/]+\/(.+)$/)?.[1] ?? null;
+}
+function startable(features, localBranches) {
+  const localSlugs = new Set(
+    localBranches.map(branchSlugOf).filter((s) => s !== null)
+  );
+  const hasLocalBranch = (f) => f.branch_slug !== null && localSlugs.has(f.branch_slug);
+  return features.filter((f) => f.stage !== "main" && !hasLocalBranch(f));
 }
 function pick(list, arg) {
   if (!arg) return list.length === 1 ? list[0] ?? null : null;
@@ -615,27 +641,25 @@ function pick(list, arg) {
   throw new CliError(`Feature n\xE3o encontrada: ${arg}. Rode 'nf start' para ver a lista.`);
 }
 async function start(io, args) {
-  const list = startable(await io.client.listFeatures());
+  const [features, localBranches] = await Promise.all([io.client.listFeatures(), io.listBranches()]);
+  const list = startable(features, localBranches);
   if (list.length === 0) {
-    throw new CliError("Nenhuma feature atribu\xEDda a iniciar (sem branch e fora de main).");
+    throw new CliError("Nenhuma feature para iniciar ou retomar (sem branch local e fora de main).");
   }
   const selected = pick(list, args.positional);
   if (!selected) {
     return { human: formatStartList(list), data: { features: list } };
   }
+  const resuming = selected.branch_slug !== null;
   const result = await io.client.startFeature(selected.id, args.slug);
   try {
     await io.createBranch(result.branch_name);
   } catch (err) {
     const code = err instanceof Error ? err.message : "";
-    if (code === "BRANCH_EXISTS") {
-      throw new CliError(
-        `branch_slug gravado, mas a branch '${result.branch_name}' j\xE1 existe. Rode: git switch ${result.branch_name}`
-      );
-    }
-    throw err;
+    if (code === "BRANCH_EXISTS") await io.switchBranch(result.branch_name);
+    else throw err;
   }
-  return { human: formatStart(result), data: result };
+  return { human: formatStart(result, { resumed: resuming }), data: result };
 }
 
 // src/commands/connect.ts
@@ -1262,14 +1286,14 @@ async function logout(io, _args) {
 }
 
 // src/index.ts
-var VERSION = "0.5.0";
+var VERSION = "0.6.0";
 var HELP = `nf \u2014 CLI do Nexus Flow
 
 Uso:
   nf login                  autoriza no navegador e salva a credencial local (sem colar nada)
   nf logout                 remove a credencial local
   nf start [<n\xBA|id>] [--slug <s>]
-                            inicia uma feature atribu\xEDda: cria a branch e grava o slug
+                            inicia (ou retoma) uma feature: cria/entra na branch e grava o slug
   nf status                 estado da feature da branch atual
   nf spec                   imprime a spec da feature
   nf move <stage> [--note]  move a feature de stage
@@ -1363,6 +1387,8 @@ ${HELP}`);
     client,
     resolveBranch: () => currentBranch(defaultGitRunner),
     createBranch: (name) => createBranch(name, defaultGitRunner),
+    switchBranch: (name) => switchBranch(name, defaultGitRunner),
+    listBranches: () => listLocalBranches(defaultGitRunner),
     readFile: (path) => readFile(path, "utf8"),
     readStdin,
     writeEnvVars: (pairs, opts) => writeEnvVars(pairs, { file: opts?.file }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h1veframework/cli",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "The CLI for H1VE — the governance & memory layer for teams building with AI. Drive your feature flow (start, status, move, spec, done) from the terminal. Works with Claude Code, Cursor and Copilot.",
   "license": "MIT",
   "type": "module",