trantor 0.18.27 → 0.18.29

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.18.27",
+  "version": "0.18.28",
   "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + crew orchestration for independent AI coding agents (Claude, Codex, Gemini, Kimi, DeepSeek)",
   "mcpServers": {
     "relay": {

package/README.md

@@ -393,10 +393,16 @@ rate, not work rate.
 
 ```
 trantor setup | doctor | connect | profile | provider | models
-        | up <agents…> | swap <old> <new> | down | seat-why <agent> | ui | advise | hub | watch
+        | new <name> | up <agents…> | swap <old> <new> | down | seat-why <agent> | ui | advise | hub | watch
         | adopt <project> | reconcile | duty | orchestrate | patrol | app | backfill | init-hooks
 ```
 
+- **`trantor new <name>`** — project genesis in one command: makes the dir under your dev root
+  (`TRANTOR_DEV_ROOT` or `~/development`), git on main (or `--from <git-url>`, or `--adopt` an
+  existing folder), seeds CLAUDE.md from `--brief <file>`, installs the auto-card hook, posts
+  the brief to the hub, and opens the first card "genesis: <name>". `--json` for machines.
+  It never spawns a session — firing the crew stays your call.
+
 - **`trantor provider`** — `list` every crew seat (built-in + brought) with availability + tier ·
   `add <name> --key … [--plan api] [--base-url <url> --models a,b]` to bring any provider (custom
   endpoints are wired into OpenCode for you) · `remove <name>`.

package/bin/cli.mjs

@@ -69,6 +69,7 @@ switch (cmd) {
   case "sweep": run("bin/sweep.mjs"); break;
   case "reconcile": run("bin/reconcile.mjs"); break;
   case "init-hooks": run("bin/init-hooks.mjs"); break;
+  case "new": run("bin/new.mjs"); break;
   case "balances": case "balance": case "credits": run("bin/balances.mjs"); break;
   case "recost": run("bin/recost.mjs"); break;
   case "handoff": run("bin/baton.mjs"); break;
@@ -208,6 +209,7 @@ switch (cmd) {
   trantor gates       verification gates: "must verify before shipping" claims that survive handoffs — [--all] [--json]
   trantor backfill    card past GIT work onto the board (solo commits that were never carded) — [--since "14 days ago"] [--dry-run]
   trantor init-hooks  install a git post-commit hook so EVERY commit auto-cards on the board (reliable solo-work backstop) — [--uninstall]
+  trantor new         project genesis: new <name> [--from <git-url>] [--brief <file>] [--dir <path>] [--adopt] [--json] — makes the dir, git main, CLAUDE.md from the brief, hooks, hub brief + first card (never spawns a session)
   trantor balances    how much credit is left on each CONFIGURED provider (from your profile) — refill before you stall — [--json]
   trantor recost      recompute sub-agent notional cost from on-disk transcripts + reseed the board (repair after upgrade) — [--dry-run]
   trantor handoff     finish this session NOW: write a handoff, open a fresh session that takes over, and close this one (manual baton)

package/bin/crew-runner.mjs

@@ -66,10 +66,35 @@ function ensureSeatWorktree(sourceDir) {
   }
 
   try { mkdirSync(join(homedir(), ".agent-bus", "worktrees", safePathSegment(PROJ)), { recursive: true }); } catch {}
-  const r = spawnSync("git", ["-C", root, "worktree", "add", "-B", branch, seatDir, "HEAD"], {
+
+  // Fast-forward the base branch before branching: the worktree should build
+  // against the latest main, not a stale checkout. (#5403)
+  const base = gitOut(["-C", root, "rev-parse", "--abbrev-ref", "HEAD"], root);
+  if (base) {
+    const remote = gitOut(["-C", root, "rev-parse", "--abbrev-ref", `${base}@{upstream}`], root);
+    if (remote) {
+      const ff = spawnSync("git", ["-C", root, "merge", "--ff-only", remote], { stdio: "ignore", timeout: 15000 });
+      if (ff && ff.status === 0) console.log(`\x1b[2m[runner]\x1b[0m ${base} fast-forwarded to ${remote}`);
+    }
+  }
+
+  const r = spawnSync("git", ["-C", root, "worktree", "add", "--no-track", "-B", branch, seatDir, "HEAD"], {
     encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 30000,
   });
-  if (r.status === 0) return seatDir;
+  if (r.status === 0) {
+    // Persist the base branch so the Review lens can name the real base instead
+    // of guessing via merge-base. Stale metadata is unset, not trusted. (#5403)
+    if (base) {
+      spawnSync("git", ["-C", seatDir, "config", `branch.${branch}.base`, base], { stdio: "ignore", timeout: 5000 });
+    }
+    // Set push.autoSetupRemote so a plain git push creates and sets upstream on
+    // first push (git >= 2.37, older clients ignore it). (#5403)
+    const pushAuto = gitOut(["-C", seatDir, "config", "--get", "push.autoSetupRemote"], seatDir);
+    if (!pushAuto) {
+      spawnSync("git", ["-C", seatDir, "config", "push.autoSetupRemote", "true"], { stdio: "ignore", timeout: 5000 });
+    }
+    return seatDir;
+  }
   console.log(`\x1b[33m[runner]\x1b[0m could not create ${branch} worktree — using ${sourceDir}`);
   return sourceDir;
 }

package/bin/crew.sh

@@ -613,13 +613,16 @@ usage: trantor open [<project>]
 EOF
 }
 open_orchestrator() {
-  local a
+  local a PROJ_ARG=""
   for a in "$@"; do case "$a" in
     --help|-h) usage_open; return 0 ;;
     --*) echo "trantor open: unknown flag '$a'"; usage_open; return 1 ;;
-    *) PROJ="$a" ;;
+    *) PROJ="$a"; PROJ_ARG="$a" ;;
   esac; done
-  DIR="$(_orch_resolve_dir "$DIR" "$PROJ")" || exit 1
+  # only an EXPLICIT name is resolved to its checkout; a project declared by RELAY_PROJECT from
+  # inside a differently named dir (the test harness, RELAY_PROJECT=<name> sessions) means "this
+  # cwd IS the project" — refusing it made `trantor open` impossible for exactly those sessions
+  DIR="$(_orch_resolve_dir "$DIR" "${PROJ_ARG:-}")" || exit 1
   command -v herdr >/dev/null 2>&1 || { echo "trantor open needs herdr (the pane host) — install: curl -fsSL https://herdr.dev/install.sh | sh"; exit 1; }
   local wsid="" orch="" live_ids="" live_names="" pair="" line fresh=0
   local sid; sid="$(_orch_sid "$PROJ")" || { echo "trantor open: could not mint a session id (uuidgen missing?)" >&2; exit 1; }

package/bin/new.mjs

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+// trantor new — project genesis, the CLI half (#5862). One command stands a project up:
+//
+//   trantor new <name> [--from <git-url>] [--brief <file>] [--dir <path>] [--adopt] [--json]
+//
+// It makes the directory under the dev root (TRANTOR_DEV_ROOT or ~/development), starts git on
+// main (or clones --from, or adopts an existing folder with --adopt), seeds CLAUDE.md from the
+// brief (verbatim brief + the trantor conventions block), installs the same auto-card hook as
+// `trantor init-hooks`, posts the brief as the hub project brief (POST /project — the same call
+// relay_project_brief makes), and opens the first card "genesis: <name>" on the new board.
+//
+// It NEVER spawns a session: the wake is genesis-2, the app half. A hub that is down downgrades
+// the genesis to a warning (card: null) — the directory is real either way, and a dead hub must
+// not make a made project look unmade.
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, appendFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ensureEnrolled, loadIdentity, signedPost } from "../hooks/lib/api.mjs";
+import { resolveHub } from "../lib/project.mjs";
+
+const ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
+
+// The trantor conventions block — what every trantor-wired project's CLAUDE.md carries so the
+// first session knows the board, the crew, and the gates exist. Kept SHORT and factual; the
+// brief above it is the project's own voice.
+const CONVENTIONS = [
+  "",
+  "## Trantor conventions",
+  "",
+  "This project is wired into Trantor (the board, the bus, the crew):",
+  "",
+  "- **Board** — work lives on the board, not in anyone's head. `trantor catchup` answers",
+  "  \"where are we?\"; the desktop app (`trantor app install`) shows the live board.",
+  "- **Crew** — `trantor up codex kimi glm` fires seats into their own worktrees; contracts go",
+  "  over the bus (`relay_send`), and every seat reports what became of its card. See the",
+  "  `/trantor:crew` skill for the full doctrine before firing anything.",
+  "- **Gates** — a card reaches done only with real evidence: the test command, the counts,",
+  "  and the observed behavior. \"It should work\" is not a state a card can be in.",
+  "- **Commits card themselves** — the post-commit hook (trantor auto-card) backfills the board",
+  "  from git; keep commit messages in the imperative and reference card ids when one exists.",
+  "",
+].join("\n");
+
+const die = (msg) => { console.error(`trantor new: ${msg}`); process.exit(1); };
+
+// ── args ────────────────────────────────────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+const flag = (n) => { const i = args.indexOf("--" + n); return i >= 0 ? args[i + 1] : null; };
+const has = (n) => args.includes("--" + n);
+const json = has("json");
+const name = args.find(a => !a.startsWith("--"));
+if (!name) die("usage: trantor new <name> [--from <git-url>] [--brief <file>] [--dir <path>] [--adopt] [--json]");
+if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name)) die(`invalid project name "${name}" — letters, digits, dot, dash, underscore`);
+const from = flag("from");
+const briefFile = flag("brief");
+const adopt = has("adopt");
+// The brief is read BEFORE anything is created: a refused genesis must leave no directory behind.
+let brief = "";
+if (briefFile) {
+  if (!existsSync(briefFile)) die(`brief file not found: ${briefFile}`);
+  brief = readFileSync(briefFile, "utf8").trimEnd();
+}
+
+// ── the directory ───────────────────────────────────────────────────────────────────────────────
+const dirArg = flag("dir");
+const devRoot = dirArg
+  ? resolve(dirArg)
+  : (process.env.TRANTOR_DEV_ROOT ? resolve(process.env.TRANTOR_DEV_ROOT) : join(homedir(), "development"));
+if (dirArg && !isAbsolute(dirArg)) { /* relative --dir is allowed; resolved above */ }
+const dir = isAbsolute(name) ? name : join(devRoot, name);
+
+const existed = existsSync(dir);
+const occupied = existed && readdirSync(dir).length > 0;
+if (occupied && !adopt) die(`"${dir}" already exists and is not empty — pass --adopt to adopt it`);
+if (adopt && !existed) die(`--adopt: "${dir}" does not exist — nothing to adopt`);
+if (!existed) mkdirSync(dir, { recursive: true });
+
+// ── git ─────────────────────────────────────────────────────────────────────────────────────────
+const git = (gitArgs) => spawnSync("git", gitArgs, { cwd: dir, encoding: "utf8" });
+const gitOk = (r, what) => { if (r.status !== 0) die(`${what} failed: ${(r.stderr || r.stdout || "").trim()}`); };
+
+let branch;
+if (from) {
+  gitOk(git(["clone", from, "."]), "git clone");
+  branch = git(["branch", "--show-current"]).stdout.trim() || "main";
+} else {
+  if (!existsSync(join(dir, ".git"))) gitOk(git(["init", "-b", "main"]), "git init");
+  branch = git(["branch", "--show-current"]).stdout.trim() || "main";
+}
+
+// ── CLAUDE.md — verbatim brief + the conventions block ──────────────────────────────────────────
+const claude = join(dir, "CLAUDE.md");
+if (existsSync(claude)) {
+  const current = readFileSync(claude, "utf8");
+  if (!current.includes("## Trantor conventions")) appendFileSync(claude, `\n${CONVENTIONS}\n`);
+} else {
+  const head = brief ? `${brief}\n` : `# ${name}\n\n(Genesis — no brief was given. Add this project's what/why/goal here.)\n`;
+  writeFileSync(claude, `${head}${CONVENTIONS}`);
+}
+
+// ── hooks — the SAME install trantor init-hooks performs, in the new repo ───────────────────────
+const hook = spawnSync(process.execPath, [join(ROOT, "bin", "init-hooks.mjs")], { cwd: dir, encoding: "utf8" });
+if (hook.status !== 0) die(`hook install failed: ${(hook.stderr || "").trim()}`);
+
+// ── the hub: brief + first card, signed like every other client ─────────────────────────────────
+const hub = resolveHub(name);
+const session = process.env.RELAY_SESSION || `genesis:${name}`;
+const identity = loadIdentity(session);
+let card = null;
+let hubError = null;
+try {
+  await ensureEnrolled(session, identity, name);
+  const briefForHub = (brief || `Genesis of ${name} — created by trantor new.`).slice(0, 600);
+  const r1 = await signedPost("/project", { project: name, brief: briefForHub, by: session }, { session, project: name, timeoutMs: 8000 });
+  if (!r1.ok) throw new Error(`hub ${r1.status} on /project`);
+  const r2 = await signedPost("/task", {
+    project: name,
+    title: `genesis: ${name}`,
+    status: "todo",
+    by: session,
+    note: "project genesis — created by trantor new",
+  }, { session, project: name, timeoutMs: 8000 });
+  if (!r2.ok) throw new Error(`hub ${r2.status} on /task`);
+  card = r2.json?.task?.id ?? null;
+} catch (e) {
+  hubError = e instanceof Error ? e.message : String(e);
+  console.error(`trantor new: hub unreachable or refusing (${hubError}) — the project exists locally; the brief and first card were NOT posted.`);
+}
+
+// ── report ──────────────────────────────────────────────────────────────────────────────────────
+if (json) {
+  console.log(JSON.stringify({ name, dir, branch, hub, card }));
+} else {
+  console.log(`✓ ${dir} (${branch}${from ? ", cloned" : adopt ? ", adopted" : ""})`);
+  console.log(`✓ CLAUDE.md seeded${brief ? " from the brief" : " (no brief — add the project's what/why/goal)"}`);
+  console.log(`✓ auto-card hook installed (trantor init-hooks)`);
+  if (card !== null) console.log(`✓ hub ${hub}: brief posted, card #${card} ("genesis: ${name}")`);
+  else if (hubError) console.log(`! hub ${hub}: brief/card not posted (${hubError})`);
+  console.log(`\nNext: cd ${dir} && claude — or fire the crew with \`trantor up\`. No session was spawned.`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.18.27",
+  "version": "0.18.29",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"
@@ -11,7 +11,7 @@
     "zod": "^4.4.3"
   },
   "scripts": {
-    "test": "node bin/slop-gate.mjs --surface desktop/src && node test.mjs && node test-scenarios.mjs && node test-failure.mjs && node test-redelivery.mjs && node test-crew-completion.mjs && node test-contracts.mjs && node test-autonomy.mjs && node test-integrate.mjs && node test-handoff.mjs && node test-handoff-summarizer.mjs && node test-baton-turn-boundary.mjs && node test-agents.mjs && node test-update.mjs && node test-handoff-guard.mjs && node test-baton-latest.mjs && node test-balances.mjs && node test-usage-live.mjs && node test-subagent-cost.mjs && node test-inbox.mjs && node test-inflight.mjs && node test-notify.mjs && node test-focus.mjs && node test-cardlog.mjs && node test-checklist.mjs && node test-relay-note.mjs && node test-reaper.mjs && node test-events.mjs && node test-proposals.mjs && node test-scrub.mjs && node test-store-delta.mjs && node test-message-re.mjs && node test-claims.mjs && node test-adopt.mjs && node test-summarize.mjs && node test-identity-core.mjs && node test-identity.mjs && node test-identity-instances.mjs && node test-duty.mjs && node test-duty-dark.mjs && node test-duty-seat.mjs && node test-discovery.mjs && node test-doctor.mjs && node test-crew-env.mjs && node test-desktop-transport.mjs && node test-crew-worktree.mjs && bash test-crew-herdr.sh && npm --prefix desktop run test --silent && node test-splitbrain.mjs && node test-overseer.mjs && node test-overseer-lib.mjs && node test-overseer-warn.mjs && node test-provider-keys.mjs && node test-inbox-delivery.mjs && node test-identity-drift.mjs && node test-inbox-staleness.mjs && node test-seats.mjs && node test-seat-identity.mjs && node test-hub-routing.mjs && node test-hook-routing.mjs && node test-relay-wait.mjs && node test-dsh-seat.mjs && node test-kimi-bridge.mjs && node test-kimi-events.mjs && python3 engine/test-routing.py && node test-reconcile.mjs && node test-resources.mjs && node test-patrol.mjs && node test-bridge.mjs && bash test-crew.sh"
+    "test": "node bin/slop-gate.mjs --surface desktop/src && node test.mjs && node test-scenarios.mjs && node test-failure.mjs && node test-redelivery.mjs && node test-crew-completion.mjs && node test-contracts.mjs && node test-autonomy.mjs && node test-integrate.mjs && node test-handoff.mjs && node test-handoff-summarizer.mjs && node test-baton-turn-boundary.mjs && node test-agents.mjs && node test-update.mjs && node test-handoff-guard.mjs && node test-baton-latest.mjs && node test-balances.mjs && node test-usage-live.mjs && node test-subagent-cost.mjs && node test-inbox.mjs && node test-inflight.mjs && node test-notify.mjs && node test-focus.mjs && node test-cardlog.mjs && node test-checklist.mjs && node test-relay-note.mjs && node test-reaper.mjs && node test-events.mjs && node test-proposals.mjs && node test-scrub.mjs && node test-store-delta.mjs && node test-message-re.mjs && node test-claims.mjs && node test-adopt.mjs && node test-summarize.mjs && node test-identity-core.mjs && node test-identity.mjs && node test-identity-instances.mjs && node test-duty.mjs && node test-duty-dark.mjs && node test-duty-seat.mjs && node test-discovery.mjs && node test-doctor.mjs && node test-crew-env.mjs && node test-desktop-transport.mjs && node test-crew-worktree.mjs && bash test-crew-herdr.sh && npm --prefix desktop run test --silent && node test-splitbrain.mjs && node test-overseer.mjs && node test-overseer-lib.mjs && node test-overseer-warn.mjs && node test-provider-keys.mjs && node test-inbox-delivery.mjs && node test-identity-drift.mjs && node test-inbox-staleness.mjs && node test-seats.mjs && node test-seat-identity.mjs && node test-hub-routing.mjs && node test-hook-routing.mjs && node test-relay-wait.mjs && node test-dsh-seat.mjs && node test-kimi-bridge.mjs && node test-kimi-events.mjs && python3 engine/test-routing.py && node test-new.mjs && node test-reconcile.mjs && node test-resources.mjs && node test-patrol.mjs && node test-bridge.mjs && bash test-crew.sh"
   },
   "description": "The hub-world for AI agent crews — orchestrate Claude Code, Codex, GLM, Kimi, DeepSeek & any OpenRouter model as live crews with a plan-aware Advisor, a Kanban/flow command center, a testing gate, and an economics brain (Scrooge).",
   "files": [

package/skills/crew/SKILL.md

@@ -32,6 +32,9 @@ PRD.md + TDD.md. The TDD MUST define one file-set per agent (no merge conflicts)
 explicit EVENT/INTERFACE CONTRACT — cross-agent bugs come from contract drift.
 
 ## Phase 1 — board setup
+0. No project yet? `trantor new <name> --brief <file>` stands one up (dir, git main, CLAUDE.md
+   from the brief, hooks, hub brief + first card) — it never spawns a session; firing the crew
+   is this phase's job.
 1. `relay_project_brief("<what + why + goal>")`
 2. One card per package: `relay_task_add(title, assignee, difficulty, model)` — set `model`
    to the advisor-routed model (or the CLI's default name); difficulty + model show as badges