Skip to content

armgit / mso

Public Imported from GitHub
0

Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.

2.8 KB
Raw Blame
import path from "node:path";
import { readBytes, writeExclusive } from "./io";
import { BACKUP_ID, type Manifest, snapshotComplete } from "./manifest";
import type { MemoryBackupVerification } from "@/lib/contracts/memory-backup";

type Receipt = { version: 1; manifestSha256: string; verifiedAt: string; result: MemoryBackupVerification };
export type IntegrityRecord = { integrity: "not-recorded" | "verified-at-recorded-time" | "receipt-invalid"; verifiedAt?: string };
const receiptPath = (directory: string, sha: string) => path.join(directory, `verification-${sha}.json`);
function valid(value: unknown, directory: string, sha: string, manifest?: Manifest): value is Receipt {
  const r = value as Receipt, v = r?.result;
  return !!r && r.version === 1 && r.manifestSha256 === sha && typeof r.verifiedAt === "string" && Number.isFinite(Date.parse(r.verifiedAt)) &&
    !!v && v.id === path.basename(directory) && v.integrity === true && v.sourceWritesPerformed === 0 && typeof v.complete === "boolean" &&
    Number.isSafeInteger(v.restoredFiles) && v.restoredFiles >= 0 && typeof v.restoreDirectory === "string" &&
    path.dirname(v.restoreDirectory) === directory && path.basename(v.restoreDirectory).startsWith("restore-check-") &&
    BACKUP_ID.test(path.basename(v.restoreDirectory).slice("restore-check-".length)) &&
    (!manifest || (v.restoredFiles === manifest.entries.length && v.complete === snapshotComplete(manifest)));
}
/** Immutable receipt of a completed rehearsal; never a claim of current re-verification. */
export async function recordVerification(directory: string, sha: string, result: MemoryBackupVerification) {
  const receipt: Receipt = { version: 1, manifestSha256: sha, verifiedAt: new Date().toISOString(), result };
  try { await writeExclusive(receiptPath(directory, sha), Buffer.from(JSON.stringify(receipt))); }
  catch (error) {
    if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
    const prior: unknown = JSON.parse((await readBytes(receiptPath(directory, sha), 4096)).toString("utf8"));
    if (!valid(prior, directory, sha) || prior.result.restoredFiles !== result.restoredFiles || prior.result.complete !== result.complete) {
      throw new Error("invalid existing verification receipt; restore evidence preserved");
    }
  }
}
export async function readVerification(directory: string, sha: string, manifest: Manifest): Promise<IntegrityRecord> {
  try {
    const receipt: unknown = JSON.parse((await readBytes(receiptPath(directory, sha), 4096)).toString("utf8"));
    return valid(receipt, directory, sha, manifest)
      ? { integrity: "verified-at-recorded-time", verifiedAt: receipt.verifiedAt }
      : { integrity: "receipt-invalid" };
  } catch (error) {
    return { integrity: (error as NodeJS.ErrnoException).code === "ENOENT" ? "not-recorded" : "receipt-invalid" };
  }
}