@miraland-labs/conduit-bridge 0.16.11 → 0.16.12

package/dist/cli.js

@@ -205,6 +205,7 @@ async function enroll() {
             token: { type: "string" },
             fuel: { type: "string" },
             machine: { type: "string" },
+            "managed-root": { type: "string" },
         },
     });
     if (!values.url || !values.token) {
@@ -216,7 +217,14 @@ async function enroll() {
     const response = await fetch(`${baseUrl}/runner/v1/connect/enroll-fast`, {
         method: "POST",
         headers: { "content-type": "application/json" },
-        body: JSON.stringify({ code: values.token, installation_id: installationId, machine_name: machineName }),
+        body: JSON.stringify({
+            code: values.token,
+            installation_id: installationId,
+            machine_name: machineName,
+            // Managed mode is declared here so the control plane can derive a workspace for a later
+            // switch — that is what lets a project be assigned from a phone with no path and no terminal.
+            ...(values["managed-root"]?.trim() ? { managed_workspace_root: values["managed-root"].trim() } : {}),
+        }),
     });
     if (!response.ok) {
         const errorText = await response.text();

package/dist/ops.js

@@ -19,6 +19,11 @@ export const OPS_VERBS = [
     "connect", "enroll", "install", "switch", "online", "offline", "status", "doctor", "disconnect", "uninstall",
 ];
 const LOCAL_FUEL_DRIVERS = new Set(["cursor", "pi", "kiro", "antigravity", "grok"]);
+/**
+ * Where Conduit checks out projects on a managed computer. Deliberately not `~/conduit`, which is
+ * where operators keep the Conduit product checkout itself. Keep in step with the console default.
+ */
+const DEFAULT_MANAGED_ROOT = "~/conduit-workspaces";
 function bridgeVersionAtLeast(value, minimum) {
     const parse = (input) => {
         const match = /^(\d+)\.(\d+)\.(\d+)/.exec(input);
@@ -95,6 +100,7 @@ export function loadOpsEnv(home = homedir(), cwd = process.cwd()) {
         CONDUIT_REPO: pick("CONDUIT_REPO", ""),
         CONDUIT_DRIVERS: pick("CONDUIT_DRIVERS", ""),
         CONDUIT_ROLES: pick("CONDUIT_ROLES", "implement research review"),
+        CONDUIT_MANAGED_ROOT: pick("CONDUIT_MANAGED_ROOT", ""),
         loadedFrom,
     };
 }
@@ -113,7 +119,7 @@ export function splitOpsList(value) {
 /** Update keys in an existing ops.env (or create from current values). Preserves comments/unknown keys when possible. */
 export function writeOpsEnvFile(path, patch, existingText) {
     mkdirSync(dirname(path), { recursive: true });
-    const keys = ["CONDUIT_URL", "CONDUIT_ORG", "CONDUIT_WORKSPACE", "CONDUIT_REPO", "CONDUIT_DRIVERS", "CONDUIT_ROLES"];
+    const keys = ["CONDUIT_URL", "CONDUIT_ORG", "CONDUIT_WORKSPACE", "CONDUIT_REPO", "CONDUIT_DRIVERS", "CONDUIT_ROLES", "CONDUIT_MANAGED_ROOT"];
     const current = existingText ?? (existsSync(path) ? readFileSync(path, "utf8") : "");
     const lines = current ? current.split(/\r?\n/) : [];
     const seen = new Set();
@@ -443,28 +449,63 @@ export async function runOps(verb, argv = [], deps = {}) {
                 repo: { type: "string" },
                 machine: { type: "string" },
                 "no-install": { type: "boolean" },
+                managed: { type: "string" },
             },
             allowPositionals: true,
         });
         const url = (values.url?.trim() || env.CONDUIT_URL).trim();
         const token = values.token?.trim();
         if (!url || !token) {
-            throw new Error("Usage: ops enroll --url <url> --token <token> [--workspace <path>] [--repo <url>] [--machine <name>]");
+            throw new Error("Usage: ops enroll --url <url> --token <token> [--managed[=<root>] | --workspace <path>] [--repo <url>] [--machine <name>]");
         }
-        const workspace = values.workspace?.trim() || env.CONDUIT_WORKSPACE;
-        const repo = values.repo?.trim() || env.CONDUIT_REPO;
+        /**
+         * Managed mode is the one-command kick-off: the operator grants Conduit one folder and never
+         * touches a terminal again. There is no repository yet, so the runner starts against the root
+         * itself and simply waits — the first project assignment (from a phone) arrives as on-shift
+         * intent and Bridge clones into <root>/<owner>/<repo> and restarts on it.
+         */
+        const managed = values.managed !== undefined;
+        const managedRoot = managed ? (values.managed?.trim() || DEFAULT_MANAGED_ROOT) : "";
+        const workspace = managed ? managedRoot : (values.workspace?.trim() || env.CONDUIT_WORKSPACE);
+        const repo = managed ? "" : (values.repo?.trim() || env.CONDUIT_REPO);
         const machine = values.machine?.trim();
         const envPath = env.loadedFrom ?? defaultOpsEnvPath();
         writeOpsEnvFile(envPath, {
             CONDUIT_URL: url,
             ...(workspace ? { CONDUIT_WORKSPACE: workspace } : {}),
             ...(repo ? { CONDUIT_REPO: repo } : {}),
+            ...(managed ? { CONDUIT_MANAGED_ROOT: managedRoot } : {}),
         });
         const args = ["enroll", "--url", url, "--token", token];
         if (machine)
             args.push("--machine", machine);
+        if (managed)
+            args.push("--managed-root", managedRoot);
         runBridge(args);
-        if (!values["no-install"] && workspace) {
+        if (values["no-install"])
+            return;
+        if (managed) {
+            const root = resolve(expandOpsValue(managedRoot));
+            mkdirSync(root, { recursive: true });
+            // Bring lanes online and install the resident runner, but skip `ops install`'s doctor gate:
+            // an empty managed root is legitimately not a checkout yet, and failing here would leave the
+            // computer with no background process — exactly the terminal round-trip this removes.
+            const detected = await detectInstalledClients();
+            const drivers = driverIdsFromDetectedLabels(detected);
+            if (drivers.length === 0) {
+                throw new Error("No coding agent detected. Install one (Claude Code, Codex, Cursor, …), then re-run this command.");
+            }
+            for (const id of drivers) {
+                if (LOCAL_FUEL_DRIVERS.has(id))
+                    runBridge(["drivers", "fuel", id, "local"]);
+            }
+            runBridge(["drivers", "online", ...drivers]);
+            applyRunnerToolPath();
+            runBridge(["install-service", "--workspace", root]);
+            console.log(`Conduit manages checkouts under ${root}. Assign this computer to a project from the console — it clones and switches on its own.`);
+            return;
+        }
+        if (workspace) {
             const refreshedEnv = loadOpsEnv();
             await runOps("install", [], { ...deps, env: refreshedEnv });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraland-labs/conduit-bridge",
-  "version": "0.16.11",
+  "version": "0.16.12",
   "description": "Conduit Bridge CLI — join, connect, disconnect, multi-driver lanes, and run Claude Code / Codex / Cursor / OpenCode / Pi / Kiro / Antigravity / Grok Build agents for a Conduit organization",
   "type": "module",
   "bin": {