offrouter-adapter-codex 0.2.1 → 0.3.0

package/dist/rollback.js

@@ -0,0 +1,219 @@
+/**
+ * Rollback for profile-scoped Codex install state.
+ * Restores the profile's config.toml to its previous content (or removes the
+ * OffRouter-created file) and drops the install-state metadata.
+ */
+import { access, mkdir, readFile, rmdir, unlink, writeFile } from "node:fs/promises";
+import { constants } from "node:fs";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { homedir as osHomedir } from "node:os";
+import { CODEX_CONFIG_REL, CODEX_INSTALL_STATE_REL, CodexInstallStateSchema, } from "./install.js";
+import { resolveCodexProfileDir } from "./profile.js";
+async function pathExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function changeSummary(kind, relativePath) {
+    switch (kind) {
+        case "create":
+            return `+ ${relativePath}`;
+        case "update":
+            return `~ ${relativePath}`;
+        case "unchanged":
+            return `= ${relativePath}`;
+        case "remove":
+            return `- ${relativePath}`;
+        default:
+            return `? ${relativePath}`;
+    }
+}
+async function loadState(statePath) {
+    if (!(await pathExists(statePath))) {
+        return {
+            ok: false,
+            errorCode: "no_install_state",
+            message: `No install state at ${statePath}. Nothing to uninstall.`,
+        };
+    }
+    try {
+        const raw = await readFile(statePath, "utf8");
+        const state = CodexInstallStateSchema.parse(JSON.parse(raw));
+        return { ok: true, state };
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            errorCode: "invalid_install_state",
+            message: `Invalid install state at ${statePath}: ${detail}`,
+        };
+    }
+}
+function isWindowsAbsolutePath(path) {
+    return /^[A-Za-z]:[\\/]/.test(path);
+}
+function isInsideOrSame(root, candidate) {
+    const rel = relative(root, candidate);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+function resolveProfileRelativePath(profileDir, relativePath) {
+    if (relativePath.trim() === "" ||
+        relativePath.includes("\0") ||
+        isAbsolute(relativePath) ||
+        isWindowsAbsolutePath(relativePath)) {
+        return null;
+    }
+    const parts = relativePath.split(/[\\/]+/);
+    if (parts.some((part) => part === "" || part === "." || part === "..")) {
+        return null;
+    }
+    const root = resolve(profileDir);
+    const candidate = resolve(root, ...parts);
+    if (!isInsideOrSame(root, candidate)) {
+        return null;
+    }
+    return candidate;
+}
+function validateRollbackState(profileDir, state) {
+    if (state.configRelative !== CODEX_CONFIG_REL) {
+        return {
+            ok: false,
+            message: `Invalid config relative path in install state: ${state.configRelative}`,
+        };
+    }
+    const configPath = resolveProfileRelativePath(profileDir, state.configRelative);
+    if (!configPath) {
+        return {
+            ok: false,
+            message: `Invalid config relative path in install state: ${state.configRelative}`,
+        };
+    }
+    for (const relativePath of Object.keys(state.files)) {
+        if (relativePath !== CODEX_CONFIG_REL) {
+            return {
+                ok: false,
+                message: `Install state path is outside config root: ${relativePath}`,
+            };
+        }
+        const abs = resolveProfileRelativePath(profileDir, relativePath);
+        if (!abs) {
+            return {
+                ok: false,
+                message: `Invalid install state path: ${relativePath}`,
+            };
+        }
+    }
+    return { ok: true, configPath };
+}
+/**
+ * Restore files tracked by codex-install-state.json for a profile.
+ */
+export async function rollbackCodexProfile(options) {
+    const { profile, dryRun = false, env = process.env, homedir = osHomedir, } = options;
+    const profileDir = options.profileDir ?? resolveCodexProfileDir(profile, { env, homedir });
+    const statePath = join(profileDir, CODEX_INSTALL_STATE_REL);
+    const loaded = await loadState(statePath);
+    if (!loaded.ok) {
+        return {
+            ok: false,
+            dryRun,
+            profile,
+            profileDir,
+            changes: [],
+            message: loaded.message,
+            errorCode: loaded.errorCode,
+        };
+    }
+    const { state } = loaded;
+    const validated = validateRollbackState(profileDir, state);
+    if (!validated.ok) {
+        return {
+            ok: false,
+            dryRun,
+            profile,
+            profileDir,
+            changes: [],
+            message: validated.message,
+            errorCode: "invalid_install_state",
+        };
+    }
+    const changes = [];
+    const configPath = validated.configPath;
+    const fileState = state.files[CODEX_CONFIG_REL];
+    const previous = fileState?.previous ?? null;
+    if (previous === null) {
+        // File was created by install; remove it on rollback.
+        const existed = await pathExists(configPath);
+        const kind = existed ? "remove" : "unchanged";
+        changes.push({
+            path: configPath,
+            relativePath: CODEX_CONFIG_REL,
+            kind,
+            summary: changeSummary(kind, CODEX_CONFIG_REL),
+        });
+        if (!dryRun && existed) {
+            await unlink(configPath);
+        }
+    }
+    else {
+        let current = null;
+        if (await pathExists(configPath)) {
+            current = await readFile(configPath, "utf8");
+        }
+        let kind;
+        if (current === previous) {
+            kind = "unchanged";
+        }
+        else if (current === null) {
+            kind = "create"; // restore missing prior content
+        }
+        else {
+            kind = "update";
+        }
+        changes.push({
+            path: configPath,
+            relativePath: CODEX_CONFIG_REL,
+            kind,
+            summary: changeSummary(kind, CODEX_CONFIG_REL),
+        });
+        if (!dryRun && kind !== "unchanged") {
+            await mkdir(dirname(configPath), { recursive: true });
+            await writeFile(configPath, previous, "utf8");
+        }
+    }
+    // Drop install state last
+    const stateChangeKind = "remove";
+    changes.push({
+        path: statePath,
+        relativePath: CODEX_INSTALL_STATE_REL,
+        kind: stateChangeKind,
+        summary: changeSummary(stateChangeKind, CODEX_INSTALL_STATE_REL),
+    });
+    if (!dryRun) {
+        await unlink(statePath);
+        // Best-effort remove only the empty install-state directory.
+        try {
+            await rmdir(join(profileDir, ".offrouter"));
+        }
+        catch {
+            // ignore
+        }
+    }
+    const applied = changes.filter((c) => c.kind !== "unchanged");
+    return {
+        ok: true,
+        dryRun,
+        profile,
+        profileDir,
+        changes,
+        message: dryRun
+            ? `Dry run: would roll back ${applied.length} change(s) for profile ${profile}.`
+            : `Rolled back OffRouter Codex install for profile ${profile} (${applied.length} change(s)).`,
+    };
+}
+//# sourceMappingURL=rollback.js.map

package/dist/rollback.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "offrouter-adapter-codex",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -9,8 +9,13 @@
     "test": "vitest run --root ../.. packages/adapter-codex/src"
   },
   "dependencies": {
-    "offrouter-core": "0.2.1",
+    "offrouter-core": "0.3.0",
     "smol-toml": "^1.7.0",
     "zod": "^3.23.0"
-  }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
 }

package/src/index.ts

@@ -1,35 +0,0 @@
-/**
- * offrouter-adapter-codex public surface.
- * Install / rollback for Codex personal profiles (MCP config entry).
- */
-
-export const ADAPTER_CODEX_PACKAGE = "offrouter-adapter-codex" as const;
-
-export {
-  isCodexHarnessProfile,
-  isSafeProfileId,
-  isWorkLikeProfile,
-  listAllowlistedPersonalCodexProfiles,
-  resolveCodexProfileDir,
-  SAFE_PROFILE_ID_RE,
-} from "./profile.js";
-export type { ResolveCodexProfileDirOptions } from "./profile.js";
-
-export {
-  CODEX_CONFIG_REL,
-  CODEX_INSTALL_STATE_REL,
-  CodexInstallStateSchema,
-  evaluateInstallProfilePolicy,
-  formatInstallDiffText,
-  installCodexProfile,
-} from "./install.js";
-export type {
-  CodexInstallOptions,
-  CodexInstallResult,
-  CodexInstallState,
-  InstallChangeKind,
-  InstallFileChange,
-} from "./install.js";
-
-export { rollbackCodexProfile } from "./rollback.js";
-export type { CodexRollbackOptions, CodexRollbackResult } from "./rollback.js";