@h1veframework/cli 0.12.2 → 0.14.0

package/dist/index.js

@@ -61,6 +61,21 @@ async function switchBranch(name, runner = defaultGitRunner) {
     throw new Error("GIT_SWITCH_FAILED");
   }
 }
+async function commitsBehindOriginMain(runner = defaultGitRunner) {
+  try {
+    await runner(["fetch", "origin"]);
+  } catch {
+    return null;
+  }
+  let out;
+  try {
+    out = await runner(["rev-list", "--count", "HEAD..origin/main"]);
+  } catch {
+    return null;
+  }
+  const n = Number(out.trim());
+  return Number.isInteger(n) && n >= 0 ? n : null;
+}
 async function listLocalBranches(runner = defaultGitRunner) {
   let out;
   try {
@@ -197,6 +212,9 @@ function createClient(config) {
     setDone(featureId, doneContent) {
       return writeAction("PATCH", featureId, "done", { done_content: doneContent });
     },
+    addDependency(featureId, dependsOnId) {
+      return postAction(featureId, "dependencies", { depends_on_id: dependsOnId });
+    },
     // SPEC-100 (B2): best-effort — o juiz de drift é ADVISORY; qualquer falha → {checked:false}
     // (nunca lança, pra não estragar o fluxo de gravar a SPEC no `set_spec` do MCP).
     async checkSpecAlignment(featureId) {
@@ -360,6 +378,26 @@ async function writeEnvVars(pairs, opts = {}) {
   return { file, keys: Object.keys(pairs) };
 }
 
+// ../core/src/format.ts
+var MINUTE_MS = 6e4;
+var HOUR_MS = 36e5;
+var DAY_MS = 864e5;
+function formatDuration(ms) {
+  if (ms < MINUTE_MS) return "<1min";
+  if (ms < HOUR_MS) return `${Math.floor(ms / MINUTE_MS)}min`;
+  if (ms < DAY_MS) {
+    const h2 = Math.floor(ms / HOUR_MS);
+    const m = Math.floor(ms % HOUR_MS / MINUTE_MS);
+    return m > 0 ? `${h2}h ${m}min` : `${h2}h`;
+  }
+  const d = Math.floor(ms / DAY_MS);
+  const h = Math.floor(ms % DAY_MS / HOUR_MS);
+  return h > 0 ? `${d}d ${h}h` : `${d}d`;
+}
+function formatMinutes(minutes) {
+  return formatDuration(minutes * MINUTE_MS);
+}
+
 // ../core/src/credentials.ts
 import {
   readFile as fsReadFile2,
@@ -457,6 +495,9 @@ async function clientFromConfig(cfg) {
 }
 
 // src/format.ts
+function activeTime(d) {
+  return d.elapsed_minutes != null ? formatMinutes(d.elapsed_minutes) : `${d.days_active}d`;
+}
 var STAGE_LABEL = {
   backlog: "Backlog",
   spec: "Spec",
@@ -476,7 +517,7 @@ function formatStatus(d) {
   const lines = [
     `${f.name}  [${f.priority}]`,
     `Stage:        ${stageLabel(d.stage)}`,
-    `Dias ativos:  ${d.days_active}`,
+    `Tempo ativo:  ${activeTime(d)}`,
     `Branch:       ${f.branch_slug ?? "\u2014"}`
   ];
   if (f.github_pr_url) lines.push(`PR:           ${f.github_pr_url}`);
@@ -516,10 +557,30 @@ function formatStartList(list) {
   const header = "Features para iniciar ou retomar \u2014 escolha: h1ve 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}`;
+    const dep = f.depends_on && f.depends_on.length > 0 ? `  \u26A0 depende de ${f.depends_on.map((d) => d.name).join(", ")}` : "";
+    return `  ${String(i + 1).padStart(2)}. ${f.name}  [${stageLabel(f.stage)}]${tag}${dep}`;
   });
   return [header, ...rows].join("\n");
 }
+var PRIORITY_RANK = { HIGH: 0, MEDIUM: 1, LOW: 2 };
+function rankStartable(list) {
+  return [...list].sort((a, b) => {
+    const resume = (a.branch_slug !== null ? 0 : 1) - (b.branch_slug !== null ? 0 : 1);
+    if (resume !== 0) return resume;
+    const blocked = (a.blocked_by_dep ? 1 : 0) - (b.blocked_by_dep ? 1 : 0);
+    if (blocked !== 0) return blocked;
+    const prio = PRIORITY_RANK[a.priority] - PRIORITY_RANK[b.priority];
+    if (prio !== 0) return prio;
+    return (a.appetite ?? 0) - (b.appetite ?? 0);
+  });
+}
+function formatDepWarning(f) {
+  if (!f.depends_on || f.depends_on.length === 0) return "";
+  const names = f.depends_on.map((d) => d.name).join(", ");
+  return `\u26A0 "${f.name}" depende de ${names} (ainda n\xE3o conclu\xEDdo) \u2014 considere fazer isso primeiro.
+
+`;
+}
 var PRE_DEV_STAGES = /* @__PURE__ */ new Set(["backlog", "spec", "blocked"]);
 function startFlowLines(r) {
   const stage = r.landed_stage ?? r.feature.stage;
@@ -554,6 +615,13 @@ function formatStart(r, opts) {
     ...startFlowLines(r)
   ].join("\n");
 }
+function formatBehindMainWarning(behind) {
+  const plural = behind === 1 ? "commit" : "commits";
+  return [
+    `\u26A0 Sua base est\xE1 ${behind} ${plural} atr\xE1s de origin/main.`,
+    "  Sincronize antes de codar: git fetch origin && git rebase origin/main"
+  ].join("\n");
+}
 function formatHealth(snaps) {
   if (!snaps.length) return "Nenhum snapshot de sa\xFAde t\xE9cnica registrado.";
   const header = "Semana     CI%  Deploys  Bugs  D\xEDvida";
@@ -705,6 +773,17 @@ async function health(io) {
 }
 
 // src/commands/start.ts
+async function behindMainWarning(io) {
+  if (!io.checkBehindMain) return "";
+  try {
+    const behind = await io.checkBehindMain();
+    return behind && behind > 0 ? `${formatBehindMainWarning(behind)}
+
+` : "";
+  } catch {
+    return "";
+  }
+}
 function branchSlugOf(branch) {
   return branch.match(/^feat\/[^/]+\/(.+)$/)?.[1] ?? null;
 }
@@ -725,7 +804,7 @@ function pick(list, arg) {
 }
 async function start(io, args) {
   const [features, localBranches] = await Promise.all([io.client.listFeatures(), io.listBranches()]);
-  const list = startable(features, localBranches);
+  const list = rankStartable(startable(features, localBranches));
   if (list.length === 0) {
     throw new CliError("Nenhuma feature para iniciar ou retomar (sem branch local e fora de main).");
   }
@@ -733,6 +812,7 @@ async function start(io, args) {
   if (!selected) {
     return { human: formatStartList(list), data: { features: list } };
   }
+  const warning = await behindMainWarning(io);
   const resuming = selected.branch_slug !== null;
   const result = await io.client.startFeature(selected.id, args.slug);
   try {
@@ -742,7 +822,8 @@ async function start(io, args) {
     if (code === "BRANCH_EXISTS") await io.switchBranch(result.branch_name);
     else throw err;
   }
-  return { human: formatStart(result, { resumed: resuming }), data: result };
+  const depWarn = formatDepWarning(selected);
+  return { human: `${warning}${depWarn}${formatStart(result, { resumed: resuming })}`, data: result };
 }
 
 // src/commands/connect.ts
@@ -1437,8 +1518,11 @@ async function mcp(io, args) {
   };
 }
 
+// src/version.ts
+import { readFileSync } from "fs";
+var VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+
 // src/index.ts
-var VERSION = "0.12.2";
 var HELP = `h1ve \u2014 CLI do H1VE
 (o comando legado \`nf\` continua funcionando como alias)
 
@@ -1562,6 +1646,7 @@ ${HELP}`);
     createBranch: (name) => createBranch(name, defaultGitRunner),
     switchBranch: (name) => switchBranch(name, defaultGitRunner),
     listBranches: () => listLocalBranches(defaultGitRunner),
+    checkBehindMain: () => commitsBehindOriginMain(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.12.2",
+  "version": "0.14.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",