youmd 0.11.0 → 0.12.0

package/dist/commands/founder.js

@@ -0,0 +1,189 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.founderOverviewSummary = founderOverviewSummary;
+exports.founderReviewUrl = founderReviewUrl;
+exports.founderCommand = founderCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const node_child_process_1 = require("node:child_process");
+const api_1 = require("../lib/api");
+const config_1 = require("../lib/config");
+const render_1 = require("../lib/render");
+const ACCENT = chalk_1.default.hex("#C46A3A");
+const DIM = chalk_1.default.dim;
+function requireAuth(json) {
+    if ((0, config_1.isAuthenticated)())
+        return true;
+    if (json)
+        console.log(JSON.stringify({ ok: false, error: "not_authenticated" }));
+    else {
+        console.log("");
+        console.log("  " + chalk_1.default.yellow("not authenticated") + DIM(" — run ") + chalk_1.default.cyan("you login"));
+        console.log("");
+    }
+    return false;
+}
+function record(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function list(value) {
+    return Array.isArray(value) ? value : [];
+}
+function founderOverviewSummary(overview) {
+    const founder = record(overview.founder);
+    const mission = record(founder.mission);
+    const missionRevision = record(mission.revision);
+    const goals = record(overview.goals);
+    const reconciler = record(overview.reconciler);
+    return {
+        mission: String(missionRevision.content
+            ?? mission.reason
+            ?? mission.status
+            ?? "review needed"),
+        businesses: list(overview.businesses).length,
+        independentProjects: list(overview.independentProjects).length,
+        goals: list(goals.flat).length,
+        openConflicts: list(reconciler.openConflicts).length,
+    };
+}
+function founderReviewUrl(revisionRef, appUrl = (0, config_1.getAppUrl)()) {
+    if (!/^vision:[a-z0-9][a-z0-9:._-]{2,239}$/i.test(revisionRef)) {
+        throw new Error("revisionRef must be a canonical vision:* reference");
+    }
+    const url = new URL("/shell", appUrl);
+    url.searchParams.set("view", "businesses");
+    url.searchParams.set("review", revisionRef);
+    return url.toString();
+}
+function openUrl(url) {
+    const [binary, args] = process.platform === "darwin"
+        ? ["open", [url]]
+        : process.platform === "win32"
+            ? ["cmd", ["/c", "start", "", url]]
+            : ["xdg-open", [url]];
+    (0, node_child_process_1.execFile)(binary, args, { windowsHide: true }, () => {
+        // The URL is always printed, so a missing platform opener is non-fatal.
+    });
+}
+async function founderOverviewCommand(options) {
+    if (!requireAuth(options.json))
+        return;
+    const spinner = options.json ? null : new render_1.BrailleSpinner("assembling the founder control plane...");
+    spinner?.start();
+    const response = await (0, api_1.getFounderOverview)();
+    if (!response.ok) {
+        spinner?.fail("Founder OS unavailable");
+        const error = (0, api_1.apiErrorMessage)(response.data) ?? `HTTP ${response.status}`;
+        if (options.json)
+            console.log(JSON.stringify({ ok: false, error }));
+        else
+            console.log("  " + chalk_1.default.red(error));
+        return;
+    }
+    spinner?.stop("Founder OS current");
+    if (options.json) {
+        console.log(JSON.stringify({ ok: true, ...response.data }, null, 2));
+        return;
+    }
+    const overview = record(response.data.overview);
+    const summary = founderOverviewSummary(overview);
+    console.log("");
+    console.log("  " + ACCENT("founder os"));
+    console.log("  " + DIM("mission: ") + summary.mission);
+    console.log("  " + DIM("portfolio: ")
+        + `${summary.businesses} businesses · ${summary.independentProjects} independent projects`);
+    console.log("  " + DIM("goals: ")
+        + `${summary.goals} · `
+        + DIM("open conflicts: ")
+        + String(summary.openConflicts));
+    console.log("");
+}
+async function founderMigrateCommand(options) {
+    if (!requireAuth(options.json))
+        return;
+    const spinner = options.json ? null : new render_1.BrailleSpinner("reconciling the legacy founder graph...");
+    spinner?.start();
+    const response = await (0, api_1.migrateFounderPortfolio)();
+    if (!response.ok) {
+        spinner?.fail("migration refused");
+        const error = (0, api_1.apiErrorMessage)(response.data) ?? `HTTP ${response.status}`;
+        if (options.json)
+            console.log(JSON.stringify({ ok: false, error }));
+        else
+            console.log("  " + chalk_1.default.red(error));
+        return;
+    }
+    spinner?.stop("canonical founder graph reconciled");
+    if (options.json)
+        console.log(JSON.stringify({ ok: true, ...response.data }, null, 2));
+    else {
+        console.log("");
+        console.log("  " + DIM("history preserved; no mission, metric, or goal was invented"));
+        console.log("");
+    }
+}
+function founderReviewCommand(revisionRef, options) {
+    if (!revisionRef) {
+        const error = "revisionRef is required";
+        if (options.json)
+            console.log(JSON.stringify({ ok: false, error }));
+        else
+            console.log("\n  " + chalk_1.default.yellow(error) + DIM(" — use you founder review vision:...\n"));
+        return;
+    }
+    try {
+        const url = founderReviewUrl(revisionRef);
+        openUrl(url);
+        if (options.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                reviewUrl: url,
+                revisionRef,
+                decisionRequiresHumanClick: true,
+                secretValuesExposed: false,
+            }, null, 2));
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("human review opened"));
+        console.log("  " + DIM("revision: ") + revisionRef);
+        console.log("  " + DIM("accept or reject only after inspecting the exact timeline and diff"));
+        console.log("  " + chalk_1.default.cyan(url));
+        console.log("");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "invalid revisionRef";
+        if (options.json)
+            console.log(JSON.stringify({ ok: false, error: message }));
+        else
+            console.log("\n  " + chalk_1.default.red(message) + "\n");
+    }
+}
+async function founderCommand(subcommand, args = [], options = {}) {
+    switch (subcommand) {
+        case undefined:
+        case "overview":
+        case "status":
+            return founderOverviewCommand(options);
+        case "migrate":
+            return founderMigrateCommand(options);
+        case "review":
+        case "decide":
+            return founderReviewCommand(args[0], options);
+        default:
+            if (options.json) {
+                console.log(JSON.stringify({ ok: false, error: `unknown subcommand: ${subcommand}` }));
+            }
+            else {
+                console.log("");
+                console.log("  " + chalk_1.default.yellow(`unknown subcommand: ${subcommand}`));
+                console.log("  " + DIM("try: ") + chalk_1.default.cyan("you founder overview | migrate | review <vision:ref>"));
+                console.log("");
+            }
+    }
+}
+//# sourceMappingURL=founder.js.map

package/dist/commands/founder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"founder.js","sourceRoot":"","sources":["../../src/commands/founder.ts"],"names":[],"mappings":"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"}

package/dist/commands/handoff.d.ts

@@ -0,0 +1,5 @@
+export interface HandoffOptions {
+    json?: boolean;
+}
+export declare function handoffCommand(subcommand: string | undefined, options?: HandoffOptions): Promise<void>;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/commands/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/commands/handoff.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAoVD,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEhH"}

package/dist/commands/handoff.js

@@ -0,0 +1,432 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handoffCommand = handoffCommand;
+const os = __importStar(require("os"));
+const chalk_1 = __importDefault(require("chalk"));
+const api_1 = require("../lib/api");
+const config_1 = require("../lib/config");
+const remote_command_1 = require("../lib/remote-command");
+const remote_executor_1 = require("../lib/remote-executor");
+const supervisor_1 = require("../lib/orchestrator/supervisor");
+const handoff_1 = require("../lib/handoff");
+const render_1 = require("../lib/render");
+const machine_identity_1 = require("../lib/machine-identity");
+const ACCENT = chalk_1.default.hex("#C46A3A");
+const DIM = chalk_1.default.dim;
+async function runFleetAction(host, action, args = {}, timeoutMs = 30000, trustedLocal = false) {
+    if (trustedLocal) {
+        return (0, remote_executor_1.executeRemoteAction)({ action, args, trustedLocal: true });
+    }
+    const dispatched = await (0, remote_command_1.dispatchRemoteCommand)({
+        machine: host,
+        action,
+        args,
+        sourceAgent: "you handoff orchestrator",
+        message: `${action}${typeof args.project === "string" ? ` ${args.project}` : ""}`,
+    });
+    if (!dispatched.ok) {
+        return {
+            ok: false,
+            action,
+            exitCode: null,
+            output: "",
+            error: dispatched.error,
+            status: "error",
+            secretValuesExposed: false,
+        };
+    }
+    const result = await (0, remote_command_1.pollForResult)({ requestId: dispatched.data.requestId, timeoutMs });
+    if (!result) {
+        return {
+            ok: false,
+            action,
+            exitCode: null,
+            output: "",
+            error: "no coordinator receipt before the bounded timeout",
+            status: "error",
+            secretValuesExposed: false,
+        };
+    }
+    return { ...result, gitState: result.gitState };
+}
+async function mapBounded(items, limit, fn) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const worker = async () => {
+        while (cursor < items.length) {
+            const index = cursor++;
+            results[index] = await fn(items[index]);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, () => worker()));
+    return results;
+}
+function parseRemoteWorkers(host, output) {
+    if (!output.trim() || /\bno workers\b/i.test(output))
+        return [];
+    return output.split("\n").flatMap((line) => {
+        const match = line.match(/^(w_[A-Za-z0-9]+) \[([^\]]+)\] (\S+) (\S+)/);
+        if (!match)
+            return [];
+        const status = ["running", "exited", "failed", "stopped"].includes(match[2])
+            ? match[2]
+            : "unknown";
+        return [{ id: match[1], host, status, harness: match[3], project: match[4] === "-" ? undefined : match[4] }];
+    });
+}
+async function inventoryFleet() {
+    const [proofsResult, graphResult] = await Promise.all([
+        (0, api_1.getMachineProofs)({ limit: 50 }),
+        (0, api_1.getPortfolioGraph)(),
+    ]);
+    if (!proofsResult.ok || !proofsResult.data) {
+        throw new Error(`machine inventory unavailable (HTTP ${proofsResult.status || "unknown"})`);
+    }
+    if (!graphResult.ok || !graphResult.data) {
+        throw new Error(`project inventory unavailable (HTTP ${graphResult.status || "unknown"})`);
+    }
+    const localMachineKey = (0, machine_identity_1.readPhysicalMachineKey)();
+    const latest = new Map();
+    for (const proof of proofsResult.data.machines) {
+        const key = proof.machineKey;
+        const seen = latest.get(key);
+        if (!seen || proof.updatedAt > seen.updatedAt)
+            latest.set(key, proof);
+    }
+    const ambiguousHosts = (0, handoff_1.findAmbiguousMachineHosts)([...latest.values()].map((proof) => ({ machineKey: proof.machineKey, host: proof.hostName })));
+    if (!localMachineKey || !latest.has(localMachineKey)) {
+        const syntheticKey = localMachineKey || "unregistered-local-machine";
+        latest.set(syntheticKey, {
+            _id: "local",
+            machineKey: syntheticKey,
+            hostName: os.hostname(),
+            rootDir: process.cwd(),
+            status: "local",
+            scanned: 0,
+            ready: 0,
+            needsEnv: 0,
+            partial: 0,
+            installPassed: 0,
+            checksPassed: 0,
+            serversPassed: 0,
+            failures: 0,
+            warnings: [],
+            secretValuesExposed: false,
+            source: "you handoff",
+            generatedAt: Date.now(),
+            updatedAt: Date.now(),
+        });
+    }
+    const machines = await mapBounded([...latest.values()], 6, async (proof) => {
+        const isLocal = Boolean(localMachineKey && proof.machineKey === localMachineKey);
+        const ambiguousHost = ambiguousHosts.has(proof.hostName.toLowerCase());
+        if (ambiguousHost) {
+            return {
+                machineKey: proof.machineKey,
+                host: proof.hostName,
+                isLocal,
+                online: false,
+                managed: false,
+                lastSeenAt: proof.updatedAt,
+                note: "hostname maps to multiple stable machine keys; remote target is ambiguous",
+            };
+        }
+        if (isLocal) {
+            return { machineKey: proof.machineKey, host: proof.hostName, isLocal: true, online: true, managed: true, lastSeenAt: proof.updatedAt };
+        }
+        if (proof.machineKey === "unregistered-local-machine") {
+            return {
+                machineKey: proof.machineKey,
+                host: proof.hostName,
+                isLocal: false,
+                online: false,
+                managed: false,
+                lastSeenAt: proof.updatedAt,
+                note: "local stable machine identity is not registered; run machine sync before handoff",
+            };
+        }
+        const status = await runFleetAction(proof.hostName, "agent.status", {}, 15000);
+        return {
+            machineKey: proof.machineKey,
+            host: proof.hostName,
+            isLocal: false,
+            online: status.ok,
+            managed: true,
+            lastSeenAt: proof.updatedAt,
+            note: status.ok ? undefined : status.error || "daemon did not answer",
+        };
+    });
+    const projects = graphResult.data.projects.map((project) => {
+        const handoffProject = {
+            slug: project.slug || project.name,
+            directoryName: project.directoryName || project.repoName || project.slug || project.name,
+            repoFullName: project.repoFullName,
+            repoUrl: project.repoUrl,
+        };
+        return { ...handoffProject, repoIdentity: (0, handoff_1.projectRemoteIdentity)(handoffProject) };
+    });
+    const workers = [];
+    for (const machine of machines) {
+        if (!machine.online)
+            continue;
+        if (machine.isLocal) {
+            workers.push(...(0, supervisor_1.refreshWorkers)().map((worker) => ({
+                id: worker.id,
+                host: machine.host,
+                project: worker.project,
+                status: worker.status,
+                harness: worker.harness,
+            })));
+            continue;
+        }
+        const listed = await runFleetAction(machine.host, "agent.list", {}, 20000);
+        if (listed.ok)
+            workers.push(...parseRemoteWorkers(machine.host, listed.output));
+        else {
+            machine.managed = false;
+            machine.note = [machine.note, `worker registry unavailable: ${listed.error || listed.status}`].filter(Boolean).join("; ");
+        }
+    }
+    const probes = machines.flatMap((machine) => projects.map((project) => ({ machine, project })));
+    const repos = await mapBounded(probes, 6, async ({ machine, project }) => {
+        if (!machine.online)
+            return { machineKey: machine.machineKey, host: machine.host, project: project.slug, availability: "offline" };
+        const result = await runFleetAction(machine.host, "git.status", { project: project.directoryName }, 25000, machine.isLocal);
+        if (!result.ok) {
+            const unmanaged = /not found|known You\.md project root|managed/i.test(result.error || result.output);
+            return {
+                host: machine.host,
+                machineKey: machine.machineKey,
+                project: project.slug,
+                availability: unmanaged ? "unmanaged" : "error",
+                note: result.error || result.output,
+            };
+        }
+        return {
+            host: machine.host,
+            machineKey: machine.machineKey,
+            project: project.slug,
+            availability: "managed",
+            dirty: result.gitState?.dirty || false,
+            branch: result.gitState?.branch ?? null,
+            ahead: result.gitState?.ahead || 0,
+            behind: result.gitState?.behind || 0,
+            headOid: result.gitState?.headOid ?? null,
+            upstream: result.gitState?.upstream ?? null,
+            upstreamOid: result.gitState?.upstreamOid ?? null,
+            remoteIdentity: result.gitState?.remoteIdentity ?? null,
+        };
+    });
+    return { machines, projects, workers, repos };
+}
+function actionLabel(action) {
+    if (action.kind === "worker_state_receipt")
+        return `${action.host}: record unverified state for ${action.workerIds.length} registered worker(s)`;
+    if (action.kind === "push_clean")
+        return `${action.host}/${action.project}: push exact clean HEAD`;
+    if (action.kind === "pull_ff_only")
+        return `${action.host}/${action.project}: git pull --ff-only`;
+    if (action.kind === "machine_sync")
+        return `${action.host}: sync identity, skills, and project context`;
+    if (action.kind === "block")
+        return `${action.hosts?.join(", ") || action.project || "fleet"}: ${action.reason}`;
+    return `${action.host || action.project || "fleet"}: ${action.reason}`;
+}
+async function executePlan(plan, inventory, json) {
+    if (!plan.safeToRun) {
+        return [{
+                action: "handoff.blocked",
+                host: os.hostname(),
+                ok: false,
+                status: "blocked",
+                error: plan.blockingReasons.join("; ") || "handoff plan is not safe to execute",
+                secretValuesExposed: false,
+            }];
+    }
+    const guarded = await (0, handoff_1.executeGuardedHandoffPlan)(plan, async (item) => {
+        let action;
+        let args = {};
+        let project;
+        if (item.kind === "worker_state_receipt")
+            action = "handoff.checkpoint";
+        else if (item.kind === "push_clean") {
+            action = "handoff.push_clean";
+            project = item.project;
+            args = {
+                project: item.target,
+                expectedHead: item.expectedHead,
+                expectedBranch: item.expectedBranch,
+                expectedUpstream: item.expectedUpstream,
+                expectedUpstreamOid: item.expectedUpstreamOid,
+                expectedRemoteIdentity: item.expectedRemoteIdentity,
+                expectedFinalOid: item.expectedFinalOid,
+            };
+        }
+        else if (item.kind === "pull_ff_only") {
+            action = "handoff.pull_clean";
+            project = item.project;
+            args = {
+                project: item.target,
+                expectedHead: item.expectedHead,
+                expectedBranch: item.expectedBranch,
+                expectedUpstream: item.expectedUpstream,
+                expectedUpstreamOid: item.expectedUpstreamOid,
+                expectedRemoteIdentity: item.expectedRemoteIdentity,
+                expectedFinalOid: item.expectedFinalOid,
+            };
+        }
+        else
+            action = "handoff.sync";
+        const spinner = json ? null : new render_1.BrailleSpinner(actionLabel(item));
+        spinner?.start();
+        const machine = inventory.machines.find((candidate) => candidate.machineKey === item.machineKey);
+        if (!machine) {
+            return { action, host: item.host, project, ok: false, status: "blocked", error: "stable machine identity disappeared after planning", secretValuesExposed: false };
+        }
+        const result = await runFleetAction(item.host, action, args, action === "handoff.sync" || action === "handoff.push_clean" ? 380000 : 120000, machine.isLocal);
+        if (result.ok)
+            spinner?.stop(chalk_1.default.green(actionLabel(item)));
+        else
+            spinner?.fail(`${actionLabel(item)} — ${result.error || result.status}`);
+        return {
+            action,
+            host: item.host,
+            project,
+            ok: result.ok,
+            status: result.status,
+            output: result.output || undefined,
+            error: result.error,
+            gitState: result.gitState,
+            secretValuesExposed: false,
+        };
+    });
+    return guarded.map((receipt) => receipt.result);
+}
+function usage() {
+    console.log("");
+    console.log("  " + ACCENT("you handoff") + DIM(" — put the fleet at an honest stopping point"));
+    console.log("");
+    console.log("  " + chalk_1.default.cyan("you handoff") + DIM("            run the guarded handoff"));
+    console.log("  " + chalk_1.default.cyan("you handoff run") + DIM("        same, explicit"));
+    console.log("  " + chalk_1.default.cyan("you handoff plan --json") + DIM(" read-only machine plan"));
+    console.log("");
+    console.log(DIM("  Registered worker state is receipted without signals; active work remains unverified until its agent checks in."));
+    console.log(DIM("  Arbitrary Codex/Claude/Cursor chats are reported as unmanaged, never invented."));
+    console.log(DIM("  Dream-cycle scheduling is deferred until it has an explicit, testable opt-in."));
+    console.log("");
+}
+async function handoffCommand(subcommand, options = {}) {
+    const mode = !subcommand || subcommand === "run" ? "run" : subcommand === "plan" || subcommand === "status" ? "plan" : null;
+    if (subcommand === "help" || subcommand === "--help" || !mode)
+        return usage();
+    if (!(0, config_1.isAuthenticated)()) {
+        const message = "not authenticated — run `you login` before coordinating the fleet";
+        if (options.json)
+            console.log(JSON.stringify({ ok: false, error: message, contract: handoff_1.HANDOFF_CONTRACT }));
+        else
+            console.log("\n  " + chalk_1.default.yellow(message) + "\n");
+        process.exitCode = 1;
+        return;
+    }
+    const spinner = options.json ? null : new render_1.BrailleSpinner("asking the You Agent orchestrator for the whole fleet...");
+    spinner?.start();
+    let inventory;
+    try {
+        inventory = await inventoryFleet();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        spinner?.fail(`fleet inventory failed — ${message}`);
+        if (options.json)
+            console.log(JSON.stringify({ ok: false, mode, contract: handoff_1.HANDOFF_CONTRACT, error: message, results: [] }, null, 2));
+        else
+            console.log("\n  " + ACCENT("handoff blocked") + " " + DIM(message) + "\n");
+        process.exitCode = 1;
+        return;
+    }
+    const plan = (0, handoff_1.buildHandoffPlan)(inventory);
+    spinner?.stop(`inventoried ${inventory.machines.length} machines, ${inventory.projects.length} projects, ${inventory.workers.length} workers`);
+    if (mode === "plan") {
+        if (options.json) {
+            console.log(JSON.stringify({ ok: plan.safeToRun, mode, contract: handoff_1.HANDOFF_CONTRACT, goal: (0, handoff_1.buildHandoffGoal)(mode), inventory, plan }, null, 2));
+        }
+        else {
+            console.log("");
+            for (const action of plan.actions)
+                console.log("  " + DIM(action.kind.padEnd(16)) + actionLabel(action));
+            console.log("");
+        }
+        if (!plan.safeToRun)
+            process.exitCode = 1;
+        return;
+    }
+    const results = await executePlan(plan, inventory, Boolean(options.json));
+    const ok = results.every((result) => result.ok) && plan.safeToRun;
+    try {
+        await (0, api_1.recordBrainActivity)({
+            source: "you-handoff",
+            channel: "orchestrator",
+            kind: "fleet-handoff",
+            title: ok ? "fleet handoff completed" : "fleet handoff needs attention",
+            detail: `${inventory.machines.length} machines; ${inventory.projects.length} projects; ${plan.conflicts.length} dirty conflicts; ${plan.offlineHosts.length} offline`,
+            status: ok ? "ok" : "warn",
+            sourceHost: os.hostname(),
+            sourceAgent: "you handoff orchestrator",
+            metadata: { schemaVersion: plan.schemaVersion, secretValuesExposed: false },
+        });
+    }
+    catch {
+        // The durable local/remote receipts remain the source of truth.
+    }
+    if (options.json) {
+        console.log(JSON.stringify({ ok, mode, contract: handoff_1.HANDOFF_CONTRACT, goal: (0, handoff_1.buildHandoffGoal)(mode), inventory, plan, results }, null, 2));
+    }
+    else {
+        console.log("");
+        console.log("  " + (ok ? chalk_1.default.green("handoff complete") : ACCENT("handoff needs attention")));
+        console.log("  " + DIM(`${plan.conflicts.length} conflicts · ${plan.offlineHosts.length} offline · ${plan.unmanaged.length} unmanaged clones`));
+        for (const action of plan.actions.filter((item) => item.kind === "block" || item.kind === "report")) {
+            console.log("  " + chalk_1.default.yellow(action.kind) + " " + actionLabel(action));
+        }
+        console.log("");
+    }
+    if (!ok)
+        process.exitCode = 1;
+}
+//# sourceMappingURL=handoff.js.map