@mulmoclaude/core 3.0.0 → 3.1.0

package/dist/google/index.js

@@ -1,10 +1,10 @@
 import { i as hasStringProp, t as errorMessage } from "../dist-D8zokgGo.js";
 import { t as truncate } from "../text-CjDbP2O1.js";
-import { t as writeFileAtomic } from "../atomic-DPpdrJzO.js";
+import { n as writeFileAtomic } from "../root-BMroU_mB.js";
 import { fetchWithTimeout } from "../utils/fetch.js";
 import { l as parseIsoDate, u as parseIsoDateTime } from "../calendarGrid-Csy2rpjp.js";
 import { t as mergeIntoExisting } from "../project-B0j_Vf_Q.js";
-import { Y as getWorkspaceRoot, d as storeFor, n as discoverCollections, nt as createForwardingLogger, rt as createHostSlot } from "../discovery-4Z-ZWFam.js";
+import { Y as getWorkspaceRoot, at as createHostSlot, d as storeFor, it as createForwardingLogger, n as discoverCollections } from "../discovery-CC7kuwHf.js";
 import { t as mulmoConfigDir } from "../paths-CkJxNZ7T.js";
 import { promises } from "node:fs";
 import path, { join } from "node:path";

package/dist/remote-host/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_remote_host = require("../remote-host-CtQjagPt.cjs");
+const require_remote_host = require("../remote-host-EQPlccB9.cjs");
+exports.COMMAND_SCOPE_PARAM = require_remote_host.COMMAND_SCOPE_PARAM;
 exports.REMOTE_HOST_PROTOCOL_VERSION = require_remote_host.REMOTE_HOST_PROTOCOL_VERSION;
 exports.RUNNER_HEALTH_STATES = require_remote_host.RUNNER_HEALTH_STATES;
 exports.buildHostPresence = require_remote_host.buildHostPresence;
@@ -10,4 +11,5 @@ exports.hostDoc = require_remote_host.hostDoc;
 exports.isExpired = require_remote_host.isExpired;
 exports.isRunnerHealth = require_remote_host.isRunnerHealth;
 exports.isRunnerHealthState = require_remote_host.isRunnerHealthState;
+exports.readCommandScope = require_remote_host.readCommandScope;
 exports.toJsonObject = require_remote_host.toJsonObject;

package/dist/remote-host/index.d.ts

@@ -58,6 +58,36 @@ export declare const isExpired: (command: Pick<Command, "expiresAt">, now: numbe
 export declare const byCreatedAt: (left: Pick<Command, "createdAt">, right: Pick<Command, "createdAt">) => number;
 export type CommandHandler = (params: JsonObject) => JsonValue | Promise<JsonValue>;
 export type CommandHandlers = Record<string, CommandHandler>;
+/** The param name a collection-serving command uses to say WHICH project's
+ *  collections it means. Reserved and documented now, before a phone client
+ *  ships, because the parts that are hard to change later are the ones being
+ *  written today. Four rules go with it:
+ *
+ *  1. **It is an OPAQUE scope, never a path.** The phone is a genuinely remote
+ *     client; an absolute root in a command, an artifact or a token publishes
+ *     the user's home directory over the wire. Mint a project id host-side and
+ *     resolve it host-side.
+ *  2. **The phone must be able to LEARN the list.** A picker needs
+ *     `{ id, label }` pairs from the host — a command of its own, or a field on
+ *     an existing listing. Designing the scope value now is what keeps that the
+ *     ONLY new thing when the feature lands.
+ *  3. **Handlers RESOLVE a scope; they do not hard-code one.** Write each
+ *     collection handler as "read the scope from params, defaulting to the
+ *     host's root" rather than calling the workspace accessor inline. Today
+ *     every call resolves the default and behaves exactly as it does now; the
+ *     day the param arrives, no handler changes.
+ *  4. **The artifact stays host-built.** A remote view's srcdoc, its inlined
+ *     image thumbnails and its token are assembled on the host, so the phone
+ *     never resolves a path itself. That is what makes (1) hold without
+ *     trusting the client. */
+export declare const COMMAND_SCOPE_PARAM = "project";
+/** Read the opaque project scope off a command's params, or `undefined` for
+ *  "the host's own root" — which is what every command means today. A
+ *  non-string (or empty) value is treated as absent rather than as an error: a
+ *  scope the host cannot resolve must fall back to the default, never to a
+ *  guess. Hosts pass the result to their own id → root resolver; this module
+ *  deliberately never sees a path. */
+export declare const readCommandScope: (params: JsonObject) => string | undefined;
 export declare const REMOTE_HOST_PROTOCOL_VERSION = 2;
 export interface HostPresence {
     online: boolean;

package/dist/remote-host/index.js

@@ -1,2 +1,2 @@
-import { a as commandsCollection, c as toJsonObject, d as isRunnerHealthState, i as coerceJsonObject, l as RUNNER_HEALTH_STATES, n as buildHostPresence, o as hostDoc, r as byCreatedAt, s as isExpired, t as REMOTE_HOST_PROTOCOL_VERSION, u as isRunnerHealth } from "../remote-host-Dba4lF3Z.js";
-export { REMOTE_HOST_PROTOCOL_VERSION, RUNNER_HEALTH_STATES, buildHostPresence, byCreatedAt, coerceJsonObject, commandsCollection, hostDoc, isExpired, isRunnerHealth, isRunnerHealthState, toJsonObject };
+import { a as coerceJsonObject, c as isExpired, d as RUNNER_HEALTH_STATES, f as isRunnerHealth, i as byCreatedAt, l as readCommandScope, n as REMOTE_HOST_PROTOCOL_VERSION, o as commandsCollection, p as isRunnerHealthState, r as buildHostPresence, s as hostDoc, t as COMMAND_SCOPE_PARAM, u as toJsonObject } from "../remote-host-CFnl1I-L.js";
+export { COMMAND_SCOPE_PARAM, REMOTE_HOST_PROTOCOL_VERSION, RUNNER_HEALTH_STATES, buildHostPresence, byCreatedAt, coerceJsonObject, commandsCollection, hostDoc, isExpired, isRunnerHealth, isRunnerHealthState, readCommandScope, toJsonObject };

package/dist/remote-host/server/index.cjs

@@ -1,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_dist = require("../../dist-CsgSfWwR.cjs");
-const require_remote_host = require("../../remote-host-CtQjagPt.cjs");
+const require_remote_host = require("../../remote-host-EQPlccB9.cjs");
 let firebase_firestore = require("firebase/firestore");
+let node_perf_hooks = require("node:perf_hooks");
 let firebase_auth = require("firebase/auth");
 let firebase_app = require("firebase/app");
 let firebase_storage = require("firebase/storage");
@@ -61,6 +62,11 @@ var matchesPathPattern = (path, pattern) => {
 */
 var unexpectedPaths = (paths, expected = []) => paths.filter((path) => !expected.some((pattern) => matchesPathPattern(path, pattern)));
 //#endregion
+//#region src/remote-host/server/monotonicClock.ts
+/** Milliseconds from an arbitrary origin, never moving backwards. Only differences
+*  between two readings mean anything — never compare one to a wall-clock time. */
+var monotonicNowMs = () => node_perf_hooks.performance.now();
+//#endregion
 //#region src/remote-host/server/presenceBeat.ts
 var PRESENCE_STALE_BEATS = 3;
 var errorText$1 = (error) => error instanceof Error ? error.message : String(error);
@@ -72,21 +78,25 @@ var notify = (report, onThrow) => {
 	}
 };
 var createPresenceBeat = (deps) => {
-	const now = deps.now ?? Date.now;
-	const state = { lastAckMs: now() };
+	const now = deps.now ?? monotonicNowMs;
+	const state = {
+		lastAckMs: now(),
+		beatsSinceAck: 0
+	};
 	const announce = (online) => {
 		const fail = (error) => notify(() => deps.onError(errorText$1(error)));
 		const ack = () => notify(() => {
 			state.lastAckMs = now();
+			state.beatsSinceAck = 0;
 		});
 		notify(() => {
 			deps.write(online).then(ack, fail);
 		}, fail);
 	};
 	const beat = () => {
-		const silentMs = now() - state.lastAckMs;
-		if (silentMs >= deps.staleAfterMs) {
-			notify(() => deps.onStale(silentMs));
+		state.beatsSinceAck += 1;
+		if (state.beatsSinceAck >= deps.staleAfterBeats) {
+			notify(() => deps.onStale(now() - state.lastAckMs));
 			return;
 		}
 		announce(true);
@@ -241,7 +251,7 @@ function handleListenError(run, error) {
 		message: error.message
 	});
 	if (run.stopped) return;
-	const now = Date.now();
+	const now = monotonicNowMs();
 	run.downSinceMs ??= now;
 	if (classifyListenerError(error) === "fatal" || shouldGiveUpListening(run.downSinceMs, now)) {
 		run.goOffline();
@@ -292,10 +302,10 @@ var buildPresenceBeat = (firestore, channel, handlers, options, onStale) => {
 		}),
 		onError: (message) => report(`presence write failed: ${message}`),
 		onStale: (silentMs) => {
-			report(`no presence write acknowledged for ${Math.round(silentMs / 1e3)}s — the remote cannot see this host`);
+			report(`no presence write acknowledged across 3 beats (${Math.round(silentMs / 1e3)}s) — the remote cannot see this host`);
 			onStale();
 		},
-		staleAfterMs: presenceStaleAfterMs(options)
+		staleAfterBeats: 3
 	});
 };
 var shutDown = (run, presence) => {
@@ -337,6 +347,7 @@ var RECONNECT_MAX_MS = ONE_MINUTE_MS;
 var SETTLE_MS = ONE_MINUTE_MS;
 var GIVE_UP_MS = 5 * ONE_MINUTE_MS;
 var PROBE_INTERVAL_MS = 90 * ONE_SECOND_MS$1;
+var RESUME_GAP_MS = ONE_MINUTE_MS;
 var reconnectDelayMs = (attempt) => Math.min(RECONNECT_MAX_MS, RECONNECT_BASE_MS * 2 ** attempt);
 var errorText = (error) => error instanceof Error ? error.message : String(error);
 var scheduleWithTimeout = (task, delayMs) => {
@@ -349,7 +360,7 @@ var setState = (ctx, next) => {
 		ctx.deps.onHealth?.({
 			state: next,
 			lastError: ctx.lastError,
-			changedAt: ctx.now()
+			changedAt: ctx.wallNow()
 		});
 	} catch (error) {
 		ctx.deps.log.warn(`host runner health observer threw: ${errorText(error)}`);
@@ -363,10 +374,22 @@ var clearProbe = (ctx) => {
 	ctx.cancelProbe?.();
 	ctx.cancelProbe = null;
 };
+var after = (ctx, delayMs, task) => {
+	const dueMs = ctx.now() + delayMs;
+	return ctx.schedule(() => {
+		const overshootMs = ctx.now() - dueMs;
+		if (overshootMs > RESUME_GAP_MS) {
+			ctx.deps.log.warn(`host runner resumed after a ${Math.round(overshootMs / ONE_SECOND_MS$1)}s gap; that time does not count as outage`);
+			ctx.downSinceMs = null;
+			ctx.attempt = 0;
+		}
+		task();
+	}, delayMs);
+};
 function scheduleProbe(ctx) {
 	if (ctx.stopped || !ctx.deps.checkAlive) return;
 	clearProbe(ctx);
-	ctx.cancelProbe = ctx.schedule(() => void runProbe(ctx), PROBE_INTERVAL_MS);
+	ctx.cancelProbe = after(ctx, PROBE_INTERVAL_MS, () => void runProbe(ctx));
 }
 var STALE_REASON = "presence went stale — the phone can no longer see this host";
 async function askAlive(ctx) {
@@ -438,7 +461,7 @@ function scheduleRelaunch(ctx) {
 	ctx.attempt += 1;
 	ctx.deps.log.warn(`host runner closed (${ctx.lastError ?? "no error reported"}); re-subscribing in ${Math.round(delayMs / ONE_SECOND_MS$1)}s`);
 	if (ctx.state !== "reconnecting") setState(ctx, "reconnecting");
-	ctx.cancelTimer = ctx.schedule(() => launch(ctx), delayMs);
+	ctx.cancelTimer = after(ctx, delayMs, () => launch(ctx));
 }
 function onUnderlyingClosed(ctx) {
 	if (ctx.stopped) return;
@@ -472,13 +495,14 @@ function launch(ctx) {
 		onUnderlyingClosed(ctx);
 		return;
 	}
-	ctx.cancelTimer = ctx.schedule(() => void settle(ctx), SETTLE_MS);
+	ctx.cancelTimer = after(ctx, SETTLE_MS, () => void settle(ctx));
 }
 function startResilientHostRunner(deps) {
 	const ctx = {
 		deps,
 		schedule: deps.schedule ?? scheduleWithTimeout,
-		now: deps.now ?? Date.now,
+		now: deps.now ?? monotonicNowMs,
+		wallNow: deps.wallNow ?? Date.now,
 		stopUnderlying: null,
 		cancelTimer: null,
 		attempt: 0,