@narumitw/pi-sync 0.30.0 → 0.34.0

package/src/sync-format.ts

@@ -1,7 +1,7 @@
-import { createHash } from "node:crypto";
 import { agentDir } from "./config.js";
+import type { PublicationCapability, RemoteHead } from "./sync-backend.js";
 import { fileHashMap } from "./sync-state.js";
-import type { LatestPointer, RemoteObject, Snapshot, SyncConfig } from "./types.js";
+import type { CommonSyncConfig, Snapshot } from "./types.js";
 
 export function formatDiff(local: Snapshot, remote: Snapshot) {
 	const localMap = fileHashMap(local);
@@ -36,19 +36,20 @@ export function formatSnapshotOnlyDiff(title: string, snapshot: Snapshot) {
 }
 
 export function formatPushSummary(
-	config: SyncConfig,
+	config: CommonSyncConfig,
+	destination: string,
 	upload: Snapshot,
-	latest: RemoteObject<LatestPointer>,
+	head: RemoteHead | undefined,
 	preservedRemoteFileCount = 0,
 	remote?: Snapshot,
 ) {
 	return [
-		`Target: ${safeTerminalText(config.target ?? "default")}`,
-		`Destination: ${formatDestination(config)}`,
+		`Sync setup: ${safeTerminalText(config.setupName)}`,
+		`Storage location: ${safeTerminalText(destination)}`,
 		`Upload ${upload.files.length} files from ${safeTerminalText(agentDir())}.`,
 		`Sessions: ${upload.syncSessions ? "included — may contain private conversations" : "not included"}`,
-		latest.value ? `Remote latest: ${latest.value.snapshot}` : "Remote latest: empty",
-		"Publication effect: latest.json will point to the new immutable snapshot.",
+		head ? `Remote latest: ${head.snapshotId}` : "Remote latest: empty",
+		"Publication effect: the backend's active head will reference the new immutable snapshot.",
 		formatPublicationPreview(remote, upload),
 		preservedRemoteFileCount > 0
 			? `Possible secrets in locally managed files were scanned before this prompt; ${preservedRemoteFileCount} preserved remote file(s) were not rescanned.`
@@ -65,14 +66,15 @@ export function formatApplyPreview(local: Snapshot, remote: Snapshot) {
 }
 
 export function formatPullSummary(
-	config: SyncConfig,
+	config: CommonSyncConfig,
+	destination: string,
 	local: Snapshot,
 	remote: Snapshot,
 	protectedSessionCount: number,
 ) {
 	return [
-		`Target: ${safeTerminalText(config.target ?? "default")}`,
-		`Destination: ${formatDestination(config)}`,
+		`Sync setup: ${safeTerminalText(config.setupName)}`,
+		`Storage location: ${safeTerminalText(destination)}`,
 		`Snapshot: ${safeTerminalText(remote.id)}`,
 		`Sessions: ${remote.syncSessions ? "included — may contain private conversations" : "not included"}`,
 		`Protected live sessions: ${protectedSessionCount || "none"}`,
@@ -82,20 +84,21 @@ export function formatPullSummary(
 }
 
 export function formatRollbackSummary(
-	config: SyncConfig,
+	config: CommonSyncConfig,
+	destination: string,
 	local: Snapshot,
 	remote: Snapshot,
 	requestedSnapshot: string,
 	protectedSessionCount: number,
 ) {
 	return [
-		`Target: ${safeTerminalText(config.target ?? "default")}`,
-		`Destination: ${formatDestination(config)}`,
+		`Sync setup: ${safeTerminalText(config.setupName)}`,
+		`Storage location: ${safeTerminalText(destination)}`,
 		`Snapshot: ${safeTerminalText(requestedSnapshot)}`,
 		`Sessions: ${remote.syncSessions ? "included — may contain private conversations" : "not included"}`,
 		`Protected live sessions: ${protectedSessionCount || "none"}`,
 		formatApplyPreview(local, remote),
-		"A local backup is created before applying; the remote latest pointer will change.",
+		"A local backup is created before applying; the backend's active head will change.",
 	].join("\n");
 }
 
@@ -131,21 +134,24 @@ function formatDirectionalChanges(
 	return lines.join("\n");
 }
 
-export function formatDestination(config: SyncConfig) {
-	let host = config.endpoint;
-	try {
-		host = new URL(config.endpoint).hostname;
-	} catch {
-		// Preserve a sanitized invalid endpoint for actionable repair output.
-	}
-	return safeTerminalText(`${host} · ${config.bucket}/${config.prefix}/profiles/${config.profile}`);
-}
-
 export function countPreservedRemoteFiles(local: Snapshot, upload: Snapshot) {
 	const localPaths = new Set(local.files.map((file) => file.path));
 	return upload.files.filter((file) => !localPaths.has(file.path)).length;
 }
 
+export function publicationCapabilityDescription(capability: PublicationCapability) {
+	switch (capability) {
+		case "lease-protected":
+			return "lease-protected (exact expected-ref update)";
+		case "atomic-conditional":
+			return "atomic-conditional (verified atomic precondition)";
+		case "conditional-required":
+			return "conditional-required (read-only until atomic preconditions are verified)";
+		case "read-check-write-verify":
+			return "read-check-write-verify (visible races rejected; simultaneous unseen races remain possible)";
+	}
+}
+
 export function safeTerminalText(value: string) {
 	// biome-ignore lint/suspicious/noControlCharactersInRegex: Escape untrusted terminal controls.
 	return value.replace(/[\u0000-\u001f\u007f-\u009f]/gu, "?");
@@ -155,14 +161,6 @@ export function redact(value: string) {
 	return value.length <= 8 ? "configured" : `${value.slice(0, 4)}…${value.slice(-4)}`;
 }
 
-export function remoteIdentity(remote: RemoteObject<LatestPointer>) {
-	return remote.missing ? "missing" : (remote.value?.snapshot ?? "unknown");
-}
-
-export function sha256(value: Buffer) {
-	return createHash("sha256").update(value).digest("hex");
-}
-
 export function errorMessage(error: unknown) {
 	return safeTerminalText(error instanceof Error ? error.message : String(error));
 }