martin-loop 0.1.2 → 0.1.4

package/dist/vendor/core/rollback.js

@@ -0,0 +1,219 @@
+import { spawnSync } from "node:child_process";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { dirname, relative, resolve } from "node:path";
+export async function captureRollbackBoundary(input) {
+    if (!input.repoRoot) {
+        return undefined;
+    }
+    const repoState = readRepoState(input.repoRoot);
+    const snapshotPaths = uniqueSorted([
+        ...repoState.trackedDirtyFiles,
+        ...repoState.untrackedFiles
+    ]);
+    const snapshots = [];
+    for (const filePath of snapshotPaths) {
+        snapshots.push(await readRollbackSnapshot(input.repoRoot, filePath));
+    }
+    return {
+        strategy: "git_head_plus_snapshot",
+        capturedAt: input.capturedAt,
+        ...(readGitScalar(input.repoRoot, ["rev-parse", "HEAD"])
+            ? { headRef: readGitScalar(input.repoRoot, ["rev-parse", "HEAD"]) }
+            : {}),
+        trackedDirtyFiles: repoState.trackedDirtyFiles,
+        untrackedFiles: repoState.untrackedFiles,
+        snapshots
+    };
+}
+export async function restoreRollbackBoundary(input) {
+    if (!input.repoRoot) {
+        return undefined;
+    }
+    if (!input.boundary) {
+        return {
+            attempted: false,
+            status: "unavailable",
+            restoredAt: input.restoredAt,
+            decision: input.decision,
+            before: emptyRepoState(),
+            after: emptyRepoState(),
+            restoredFiles: [],
+            deletedFiles: [],
+            error: "Rollback boundary was unavailable for this attempt."
+        };
+    }
+    const before = readRepoState(input.repoRoot);
+    if (repoStateMatchesBoundary(before, input.boundary)) {
+        return {
+            attempted: false,
+            status: "not_required",
+            restoredAt: input.restoredAt,
+            decision: input.decision,
+            before,
+            after: before,
+            restoredFiles: [],
+            deletedFiles: []
+        };
+    }
+    const restoredFiles = new Set();
+    const deletedFiles = new Set();
+    try {
+        const baselineTracked = new Set(input.boundary.trackedDirtyFiles);
+        const baselineUntracked = new Set(input.boundary.untrackedFiles);
+        for (const filePath of before.trackedDirtyFiles) {
+            if (!baselineTracked.has(filePath)) {
+                restoreTrackedFileFromHead(input.repoRoot, filePath);
+                restoredFiles.add(filePath);
+            }
+        }
+        for (const filePath of before.untrackedFiles) {
+            if (!baselineUntracked.has(filePath)) {
+                await removeRepoPath(input.repoRoot, filePath);
+                deletedFiles.add(filePath);
+            }
+        }
+        for (const snapshot of input.boundary.snapshots) {
+            await restoreRollbackSnapshot(input.repoRoot, snapshot);
+            if (snapshot.existed) {
+                restoredFiles.add(snapshot.path);
+            }
+            else {
+                deletedFiles.add(snapshot.path);
+            }
+        }
+        const after = readRepoState(input.repoRoot);
+        const restored = repoStateMatchesBoundary(after, input.boundary);
+        return {
+            attempted: true,
+            status: restored ? "restored" : "failed",
+            restoredAt: input.restoredAt,
+            decision: input.decision,
+            before,
+            after,
+            restoredFiles: [...restoredFiles].sort(),
+            deletedFiles: [...deletedFiles].sort(),
+            ...(restored
+                ? {}
+                : { error: "Repo state still diverged from the recorded rollback boundary after restore." })
+        };
+    }
+    catch (error) {
+        const after = readRepoState(input.repoRoot);
+        return {
+            attempted: true,
+            status: "failed",
+            restoredAt: input.restoredAt,
+            decision: input.decision,
+            before,
+            after,
+            restoredFiles: [...restoredFiles].sort(),
+            deletedFiles: [...deletedFiles].sort(),
+            error: toErrorMessage(error)
+        };
+    }
+}
+function readRepoState(repoRoot) {
+    return {
+        trackedDirtyFiles: readGitLines(repoRoot, ["diff", "--name-only", "HEAD"]),
+        untrackedFiles: readGitLines(repoRoot, ["ls-files", "--others", "--exclude-standard"])
+    };
+}
+function readGitLines(repoRoot, args) {
+    const result = spawnSync("git", args, {
+        cwd: repoRoot,
+        encoding: "utf8"
+    });
+    if (result.status !== 0 || typeof result.stdout !== "string") {
+        return [];
+    }
+    return uniqueSorted(result.stdout
+        .split(/\r?\n/u)
+        .map((line) => normalizeRepoPath(line))
+        .filter(Boolean));
+}
+function readGitScalar(repoRoot, args) {
+    const result = spawnSync("git", args, {
+        cwd: repoRoot,
+        encoding: "utf8"
+    });
+    if (result.status !== 0 || typeof result.stdout !== "string") {
+        return undefined;
+    }
+    const value = result.stdout.trim();
+    return value.length > 0 ? value : undefined;
+}
+async function readRollbackSnapshot(repoRoot, filePath) {
+    const absolutePath = resolveRepoPath(repoRoot, filePath);
+    try {
+        const contents = await readFile(absolutePath);
+        return {
+            path: normalizeRepoPath(filePath),
+            existed: true,
+            encoding: "base64",
+            contentBase64: contents.toString("base64")
+        };
+    }
+    catch {
+        return {
+            path: normalizeRepoPath(filePath),
+            existed: false,
+            encoding: "base64"
+        };
+    }
+}
+async function restoreRollbackSnapshot(repoRoot, snapshot) {
+    const absolutePath = resolveRepoPath(repoRoot, snapshot.path);
+    if (!snapshot.existed || !snapshot.contentBase64) {
+        await rm(absolutePath, { recursive: true, force: true });
+        return;
+    }
+    await mkdir(dirname(absolutePath), { recursive: true });
+    await writeFile(absolutePath, Buffer.from(snapshot.contentBase64, "base64"));
+}
+function restoreTrackedFileFromHead(repoRoot, filePath) {
+    const result = spawnSync("git", ["restore", "--staged", "--worktree", "--source=HEAD", "--", filePath], {
+        cwd: repoRoot,
+        encoding: "utf8"
+    });
+    if (result.status !== 0) {
+        throw new Error(result.stderr?.trim() || `git restore failed for ${filePath}`);
+    }
+}
+async function removeRepoPath(repoRoot, filePath) {
+    await rm(resolveRepoPath(repoRoot, filePath), { recursive: true, force: true });
+}
+function resolveRepoPath(repoRoot, filePath) {
+    const resolvedRoot = resolve(repoRoot);
+    const resolvedPath = resolve(resolvedRoot, filePath);
+    const relativePath = relative(resolvedRoot, resolvedPath);
+    if (relativePath.startsWith("..") || relativePath === "") {
+        throw new Error(`Refusing to access a rollback path outside repo root: ${filePath}`);
+    }
+    return resolvedPath;
+}
+function repoStateMatchesBoundary(state, boundary) {
+    return arraysEqual(state.trackedDirtyFiles, boundary.trackedDirtyFiles) &&
+        arraysEqual(state.untrackedFiles, boundary.untrackedFiles);
+}
+function arraysEqual(left, right) {
+    if (left.length !== right.length) {
+        return false;
+    }
+    return left.every((value, index) => value === right[index]);
+}
+function uniqueSorted(values) {
+    return [...new Set(values.map((value) => normalizeRepoPath(value)).filter(Boolean))].sort();
+}
+function normalizeRepoPath(value) {
+    return value.trim().replace(/\\/gu, "/");
+}
+function emptyRepoState() {
+    return {
+        trackedDirtyFiles: [],
+        untrackedFiles: []
+    };
+}
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=rollback.js.map

package/docs/oss/OSS-BOUNDARY-REPORT.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-21T09:43:03.509Z",
+  "generatedAt": "2026-04-23T15:03:09.849Z",
   "verdict": "go",
   "publicSurface": {
     "packageName": "martin-loop",

package/docs/oss/OSS-BOUNDARY-REPORT.md

@@ -1,6 +1,6 @@
 # Martin Loop Phase 13 OSS Core Boundary
 
-Generated: 2026-04-21T09:43:03.509Z
+Generated: 2026-04-23T15:03:09.849Z
 
 ## Verdict
 **GO**

package/docs/oss/RELEASE-SURFACE-REPORT.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-21T09:43:03.931Z",
+  "generatedAt": "2026-04-23T15:03:11.006Z",
   "publicSurface": {
     "packageName": "martin-loop",
     "installCommand": "npm install martin-loop",

package/docs/oss/RELEASE-SURFACE-REPORT.md

@@ -1,6 +1,6 @@
 # Martin Loop Phase 13 Release Surface Audit
 
-Generated: 2026-04-21T09:43:03.931Z
+Generated: 2026-04-23T15:03:11.006Z
 
 ## Verdict
 **GO**

package/package.json

@@ -1,54 +1,54 @@
-{
-  "name": "martin-loop",
-  "private": false,
-  "version": "0.1.2",
-  "type": "module",
-  "description": "Martin Loop dual-track monorepo for the OSS runtime and hosted SaaS control plane.",
-  "packageManager": "pnpm@10.17.1",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "martin-loop": "./dist/bin/martin-loop.js",
-    "martin": "./dist/bin/martin-loop.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "docs/oss"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "pnpm -r build && node ./scripts/build-public-facade.mjs",
-    "test": "pnpm -r test",
-    "lint": "pnpm -r lint",
-    "oss:validate": "node ./scripts/oss-boundary.mjs",
-    "release:surface:validate": "node ./scripts/release-surface-audit.mjs",
-    "pilot:prep:validate": "node ./scripts/pilot-prep-audit.mjs",
-    "public:smoke": "node ./scripts/public-facade-smoke.mjs",
-    "repo:smoke": "node ./scripts/repo-backed-smoke.mjs",
-    "rc:validate": "node ./scripts/rc-validation.mjs",
-    "rc:validate:install": "node ./scripts/rc-validation.mjs --install",
-    "release:matrix:local": "node ./scripts/release-matrix.mjs",
-    "dev:control-plane": "pnpm --filter @martin/control-plane dev",
-    "run:cli": "pnpm --filter @martin/cli dev",
-    "eval": "pnpm --filter @martin/benchmarks eval",
-    "dev:dashboard": "node apps/local-dashboard/server.js"
-  },
-  "devDependencies": {
-    "@types/node": "^22.13.10",
-    "@types/react": "^19.0.12",
-    "@types/react-dom": "^19.0.5",
-    "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
-    "vitest": "^3.0.8"
-  }
-}
+{
+  "name": "martin-loop",
+  "private": false,
+  "version": "0.1.4",
+  "type": "module",
+  "description": "Martin Loop dual-track monorepo for the OSS runtime and hosted SaaS control plane.",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "martin-loop": "./dist/bin/martin-loop.js",
+    "martin": "./dist/bin/martin-loop.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "docs/oss"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "@types/react": "^19.0.12",
+    "@types/react-dom": "^19.0.5",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.8"
+  },
+  "scripts": {
+    "build": "pnpm -r build && node ./scripts/build-public-facade.mjs",
+    "test": "pnpm -r test",
+    "lint": "pnpm -r lint",
+    "oss:validate": "node ./scripts/oss-boundary.mjs",
+    "release:surface:validate": "node ./scripts/release-surface-audit.mjs",
+    "pilot:prep:validate": "node ./scripts/pilot-prep-audit.mjs",
+    "public:smoke": "node ./scripts/public-facade-smoke.mjs",
+    "repo:smoke": "node ./scripts/repo-backed-smoke.mjs",
+    "rc:validate": "node ./scripts/rc-validation.mjs",
+    "rc:validate:install": "node ./scripts/rc-validation.mjs --install",
+    "release:matrix:local": "node ./scripts/release-matrix.mjs",
+    "dev:control-plane": "pnpm --filter @martin/control-plane dev",
+    "run:cli": "pnpm --filter @martin/cli dev",
+    "eval": "pnpm --filter @martin/benchmarks eval",
+    "dev:dashboard": "node apps/local-dashboard/server.js"
+  }
+}