feat: move CLI config to cross-platform config directory (#130)

* feat: move CLI config to cross-platform config directory

Move CLI state from ~/.prismic to ~/.config/prismic/ with separate files
per concern (credentials.json, update-notifier.json). Drop Slice Machine
auth format compatibility (base/cookies fields, checkIsSliceMachineProject
branching). Support PRISMIC_CONFIG_DIR env var override.

Resolves #126

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* refactor: reorganize config, project, and auth file responsibilities

- Merge src/config.ts (prismic.config.json CRUD) into src/project.ts
  since both are project-level concerns
- Recreate src/config.ts as the CLI config directory module
  (CREDENTIALS_PATH, UPDATE_NOTIFIER_STATE_PATH)
- src/auth.ts now imports paths from src/config.ts instead of owning them
- Update all import paths across consumers

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* refactor: remove section headings and add Error suffix to custom errors

Rename: InvalidPrismicConfig, MissingPrismicConfig, UnknownProjectRoot,
InvalidLegacySliceMachineConfig, MissingLegacySliceMachineConfig — all
now have an Error suffix.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: use PRISMIC_CONFIG_DIR in tests to avoid XDG_CONFIG_HOME mismatch on Linux

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: clean up stale ~/.prismic files with update-notifier properties

The old CLI wrote latestKnownVersion/lastUpdateCheckAt into ~/.prismic,
breaking Slice Machine's backward compatibility. On startup, detect and
delete these files so they don't interfere.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: angeloashmore

src/adapters/index.ts

@@ -6,7 +6,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { generateTypes } from "prismic-ts-codegen";
 import { glob } from "tinyglobby";
 
-import { addRoute, removeRoute, updateRoute } from "../config";
+import { addRoute, removeRoute, updateRoute } from "../project";
 import { readJsonFile, writeFileRecursive } from "../lib/file";
 import { stringify } from "../lib/json";
 import { readPackageJson } from "../lib/packageJson";

src/adapters/nextjs.ts

@@ -6,7 +6,7 @@ import { relative } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import { Adapter } from ".";
-import { buildRoutePath } from "../config";
+import { buildRoutePath } from "../project";
 import { exists, writeFileRecursive } from "../lib/file";
 import { addDependencies, findPackageJson, getNpmPackageVersion } from "../lib/packageJson";
 import { dedent } from "../lib/string";

src/adapters/nuxt.ts

@@ -7,7 +7,7 @@ import { relative } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import { Adapter } from ".";
-import { buildRoutePath, readConfig, updateConfig } from "../config";
+import { buildRoutePath, readConfig, updateConfig } from "../project";
 import { exists, writeFileRecursive } from "../lib/file";
 import { addDependencies, getNpmPackageVersion } from "../lib/packageJson";
 import { dedent } from "../lib/string";

src/adapters/sveltekit.ts

@@ -8,7 +8,7 @@ import { relative } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import { Adapter } from ".";
-import { buildRoutePath } from "../config";
+import { buildRoutePath } from "../project";
 import { exists, writeFileRecursive } from "../lib/file";
 import { addDependencies, findPackageJson, getNpmPackageVersion } from "../lib/packageJson";
 import { dedent } from "../lib/string";

src/auth.ts

@@ -1,99 +1,70 @@
-import { readFile, rm, writeFile } from "node:fs/promises";
+import { readFile, rm } from "node:fs/promises";
 import { createServer } from "node:http";
 import { homedir } from "node:os";
 import { pathToFileURL } from "node:url";
 import * as z from "zod/mini";
 
 import { refreshToken as baseRefreshToken } from "./clients/auth";
+import { CREDENTIALS_PATH } from "./config";
 import { DEFAULT_PRISMIC_HOST, env } from "./env";
-import { exists } from "./lib/file";
+import { exists, writeFileRecursive } from "./lib/file";
 import { stringify } from "./lib/json";
 import { appendTrailingSlash } from "./lib/url";
-import { checkIsSliceMachineProject } from "./project";
 
-export const AUTH_FILE_PATH = new URL(".prismic", appendTrailingSlash(pathToFileURL(homedir())));
 const LOGIN_TIMEOUT_MS = 3 * 60 * 1000; // 3 minutes
 const PREFERRED_PORT = 5555;
 const LOGIN_SOURCE = "prismic-cli";
 
-const AuthFileSchema = z.looseObject({
+const CredentialsSchema = z.looseObject({
 	token: z.optional(z.string().check(z.minLength(1))),
 	host: z.optional(z.string().check(z.minLength(1))),
-
-	// Update notifier state
-	latestKnownVersion: z.optional(z.string()),
-	lastUpdateCheckAt: z.optional(z.number()),
-
-	// Backward compatibility with Slice Machine's .prismic
-	base: z.optional(z.string()),
-	cookies: z.optional(z.string()),
 });
-type AuthFile = z.infer<typeof AuthFileSchema>;
+type Credentials = z.infer<typeof CredentialsSchema>;
 
 export async function getToken(): Promise<string | undefined> {
-	const auth = await readAuthFile();
-	const isSliceMachineProject = await checkIsSliceMachineProject();
-	if (isSliceMachineProject && auth?.cookies) {
-		for (const cookie of auth.cookies.split("; ")) {
-			if (cookie.startsWith("prismic-auth=")) return cookie.replace(/^prismic-auth=/, "");
-		}
-	}
-	return auth?.token;
+	const credentials = await readCredentials();
+	return credentials?.token;
 }
 
 export async function getHost(): Promise<string> {
 	if (env.PRISMIC_HOST) return env.PRISMIC_HOST;
-	const auth = await readAuthFile();
-	const isSliceMachineProject = await checkIsSliceMachineProject();
-	if (isSliceMachineProject && auth?.base) {
-		try {
-			return new URL(auth.base).host || DEFAULT_PRISMIC_HOST;
-		} catch {}
-	}
-	return auth?.host || DEFAULT_PRISMIC_HOST;
+	const credentials = await readCredentials();
+	return credentials?.host || DEFAULT_PRISMIC_HOST;
 }
 
 export async function refreshToken(): Promise<string | undefined> {
 	const token = await getToken();
 	if (!token) return;
 	const host = await getHost();
 	const newToken = await baseRefreshToken(token, { host });
-	await saveAuthFile({ token: newToken, host });
+	await saveCredentials({ token: newToken, host });
 	return newToken;
 }
 
 export async function logout(): Promise<boolean> {
-	const authFileExists = await exists(AUTH_FILE_PATH);
-	if (!authFileExists) return true;
+	const credentialsExist = await exists(CREDENTIALS_PATH);
+	if (!credentialsExist) return true;
 
 	try {
-		await rm(AUTH_FILE_PATH, { force: true });
+		await rm(CREDENTIALS_PATH, { force: true });
 		return true;
 	} catch {
 		return false;
 	}
 }
 
-export async function readAuthFile(): Promise<AuthFile | undefined> {
+async function readCredentials(): Promise<Credentials | undefined> {
 	try {
-		const contents = await readFile(AUTH_FILE_PATH, "utf-8");
+		const contents = await readFile(CREDENTIALS_PATH, "utf-8");
 		const json = JSON.parse(contents);
-		return z.parse(AuthFileSchema, json);
+		return z.parse(CredentialsSchema, json);
 	} catch {
 		return undefined;
 	}
 }
 
-export async function saveAuthFile(auth: AuthFile): Promise<void> {
-	const existingAuthFile = await readAuthFile();
-	const newAuthFile: AuthFile = { ...existingAuthFile, ...auth };
-	const isSliceMachineProject = await checkIsSliceMachineProject();
-	if (isSliceMachineProject) {
-		if (newAuthFile.host) newAuthFile.base = `https://${newAuthFile.host}/`;
-		if (newAuthFile.token)
-			newAuthFile.cookies = `prismic-auth=${newAuthFile.token}; Path=/; SameSite=none; SESSION=fake_session; Path=/; SameSite=none`;
-	}
-	await writeFile(AUTH_FILE_PATH, stringify(newAuthFile));
+async function saveCredentials(credentials: Credentials): Promise<void> {
+	await writeFileRecursive(CREDENTIALS_PATH, stringify(credentials));
 }
 
 export async function createLoginSession(options?: {
@@ -139,7 +110,7 @@ export async function createLoginSession(options?: {
 							return;
 						}
 
-						await saveAuthFile({ token, host });
+						await saveCredentials({ token, host });
 
 						res.writeHead(200, {
 							"Access-Control-Allow-Origin": corsOrigin,
@@ -197,6 +168,33 @@ export async function createLoginSession(options?: {
 	});
 }
 
+const LEGACY_AUTH_FILE_PATH = new URL(
+	".prismic",
+	appendTrailingSlash(pathToFileURL(homedir())),
+);
+
+export async function cleanupLegacyAuthFile(): Promise<void> {
+	let contents: string;
+	try {
+		contents = await readFile(LEGACY_AUTH_FILE_PATH, "utf-8");
+	} catch {
+		return;
+	}
+
+	try {
+		const json = JSON.parse(contents);
+		if (!json || (json.latestKnownVersion === undefined && json.lastUpdateCheckAt === undefined)) {
+			return;
+		}
+	} catch {
+		return;
+	}
+
+	try {
+		await rm(LEGACY_AUTH_FILE_PATH, { force: true });
+	} catch {}
+}
+
 async function buildLoginUrl(host: string, port: number): Promise<URL> {
 	const url = new URL("dashboard/cli/login", `https://${host}/`);
 	url.searchParams.set("source", LOGIN_SOURCE);

src/commands/init.ts

@@ -6,12 +6,12 @@ import { getProfile } from "../clients/user";
 import {
 	createConfig,
 	deleteLegacySliceMachineConfig,
-	InvalidLegacySliceMachineConfig,
-	MissingPrismicConfig,
+	InvalidLegacySliceMachineConfigError,
+	MissingPrismicConfigError,
 	readConfig,
 	readLegacySliceMachineConfig,
-	UnknownProjectRoot,
-} from "../config";
+	UnknownProjectRootError,
+} from "../project";
 import { DEFAULT_PRISMIC_HOST } from "../env";
 import { openBrowser } from "../lib/browser";
 import { CommandError, createCommand, type CommandConfig } from "../lib/command";
@@ -50,7 +50,7 @@ export default createCommand(config, async ({ values }) => {
 			"A prismic.config.json file exists. This project is already initialized.",
 		);
 	} catch (error) {
-		if (error instanceof MissingPrismicConfig) {
+		if (error instanceof MissingPrismicConfigError) {
 			// No config found — proceed with initialization.
 		} else {
 			throw error;
@@ -62,7 +62,7 @@ export default createCommand(config, async ({ values }) => {
 	try {
 		legacySliceMachineConfig = await readLegacySliceMachineConfig();
 	} catch (error) {
-		if (error instanceof InvalidLegacySliceMachineConfig) {
+		if (error instanceof InvalidLegacySliceMachineConfigError) {
 			console.warn("Could not read slicemachine.config.json, ignoring.");
 		}
 	}
@@ -125,7 +125,7 @@ export default createCommand(config, async ({ values }) => {
 			routes: [],
 		});
 	} catch (error) {
-		if (error instanceof UnknownProjectRoot) {
+		if (error instanceof UnknownProjectRootError) {
 			throw new CommandError(
 				"Could not find a package.json file. Run this command from a project directory.",
 			);