overleaf-codex 0.1.0-rc.1

package/dist/compile/compileFlow.d.ts

@@ -0,0 +1,32 @@
+import { type BackendProjectInput, type CompileLogEntry, type CompileResult, type OverleafBackend, type OverleafBackendFactory } from "../backend/index.js";
+import { type OlcxError } from "../errors.js";
+export interface CompileFastFallbackOverrides {
+    enabled?: boolean;
+    attempts?: number;
+    timeoutMs?: number;
+}
+export interface CompileProjectInput {
+    cwd: string;
+    pdfPath?: string;
+    backend?: OverleafBackend;
+    createBackend?: OverleafBackendFactory;
+    env?: Record<string, string | undefined>;
+    now?: () => Date;
+    fastFallback?: CompileFastFallbackOverrides;
+}
+export interface CompileProjectResult {
+    projectRoot: string;
+    pdfPath: string;
+    absolutePdfPath: string;
+    status: "success" | "fallback-success";
+    warnings: string[];
+    logs: CompileLogEntry[];
+    elapsedMs: number;
+    fallbackUsed: boolean;
+    bytesWritten: number;
+}
+export declare function compileProject(input: CompileProjectInput): Promise<CompileProjectResult>;
+export declare function runCompileWithTimeout(run: () => Promise<CompileResult>, timeoutMs: number): Promise<CompileResult>;
+export declare function createCompileFailure(compile: CompileResult): OlcxError;
+export declare function downloadPdfAfterSuccessfulCompile(backend: OverleafBackend, input: BackendProjectInput, compile: CompileResult): Promise<Uint8Array>;
+export declare function summarizeCompileLogs(logs: CompileLogEntry[], limit?: number): string[];

package/dist/compile/compileFlow.js

@@ -0,0 +1,290 @@
+import { resolveProjectAuth } from "../auth/projectAuth.js";
+import { createOlcliOverleafBackend, } from "../backend/index.js";
+import { readProjectConfig } from "../config/projectConfig.js";
+import { findProjectRoot } from "../config/projectRoot.js";
+import { MAX_FAST_FALLBACK_ATTEMPTS } from "../config/types.js";
+import { createOlcxError, isOlcxError } from "../errors.js";
+import { resolvePdfOutputTarget, writePdfOutput } from "./pdfOutput.js";
+export async function compileProject(input) {
+    const projectRoot = await findProjectRoot(input.cwd);
+    const config = await readProjectConfig(projectRoot);
+    const auth = await resolveProjectAuth(projectRoot, {
+        env: input.env,
+        now: input.now,
+    });
+    const outputTarget = resolvePdfOutputTarget(projectRoot, input.pdfPath ?? config.pdfPath);
+    const backend = input.backend ??
+        (input.createBackend ?? createOlcliOverleafBackend)({ baseUrl: config.overleaf.baseUrl });
+    const fastFallback = resolveFastFallbackConfig(config.compile.fastFallback, input.fastFallback);
+    const compileInput = {
+        projectId: config.projectId,
+        auth,
+        timeoutMs: config.compile.timeoutMs,
+        rootDocument: config.rootDocument,
+        fastMode: undefined,
+    };
+    const normal = await runCompilePhase(backend, compileInput, config.compile.timeoutMs);
+    if (normal.ok) {
+        return writeSuccessfulCompile({ projectRoot, outputTarget, backend, compileInput, compile: normal.compile });
+    }
+    if (!isRecoverableCompileFailure(normal) || !fastFallback.enabled || fastFallback.attempts === 0) {
+        throw normal.error;
+    }
+    const fallback = await runFastFallback({
+        projectRoot,
+        outputTarget,
+        backend,
+        compileInput,
+        normal,
+        attempts: fastFallback.attempts,
+        timeoutMs: fastFallback.timeoutMs,
+    });
+    return fallback;
+}
+async function writeSuccessfulCompile(input) {
+    const { projectRoot, outputTarget, backend, compileInput, compile } = input;
+    const pdfBytes = compile.pdfBytes ?? (await downloadPdfAfterSuccessfulCompile(backend, compileInput, compile));
+    const written = await writePdfOutput(outputTarget, pdfBytes);
+    return {
+        projectRoot,
+        pdfPath: written.relativePath,
+        absolutePdfPath: written.absolutePath,
+        status: compile.status,
+        warnings: compile.warnings,
+        logs: compile.logs,
+        elapsedMs: compile.elapsedMs,
+        fallbackUsed: compile.fallbackUsed,
+        bytesWritten: written.bytesWritten,
+    };
+}
+async function runFastFallback(input) {
+    let session;
+    let restoreStatus = "restore-not-started";
+    let restoreWarning;
+    let fallback;
+    try {
+        session = await beginFastCompileSession(input.backend, {
+            projectId: input.compileInput.projectId,
+            auth: input.compileInput.auth,
+        });
+        for (let attempt = 0; attempt < input.attempts; attempt += 1) {
+            const fallbackInput = {
+                ...input.compileInput,
+                ...session.compileOptions,
+                timeoutMs: input.timeoutMs,
+            };
+            fallback = await runCompilePhase(input.backend, fallbackInput, input.timeoutMs);
+            if (fallback.ok) {
+                break;
+            }
+        }
+    }
+    catch (error) {
+        if (!isOlcxError(error)) {
+            throw error;
+        }
+        fallback = { ok: false, error };
+    }
+    finally {
+        if (session) {
+            try {
+                const restore = await session.restore();
+                restoreStatus = restore.status;
+                restoreWarning = restore.warning;
+            }
+            catch (error) {
+                restoreStatus = "restore-failed";
+                restoreWarning = error instanceof Error ? error.message : String(error);
+            }
+        }
+    }
+    if (fallback?.ok) {
+        const warnings = [...fallback.compile.warnings];
+        if (restoreWarning) {
+            warnings.push(`Fast/draft compile settings restore warning: ${restoreWarning}`);
+        }
+        return writeSuccessfulCompile({
+            projectRoot: input.projectRoot,
+            outputTarget: input.outputTarget,
+            backend: input.backend,
+            compileInput: input.compileInput,
+            compile: { ...fallback.compile, warnings },
+        });
+    }
+    throw createFallbackFailure({
+        normal: input.normal,
+        fallback,
+        restoreStatus,
+        restoreWarning,
+    });
+}
+async function runCompilePhase(backend, input, timeoutMs) {
+    try {
+        const compile = await runCompileWithTimeout(() => backend.compile(input), timeoutMs);
+        if (isSuccessfulCompile(compile)) {
+            return { ok: true, compile };
+        }
+        return { ok: false, error: createCompileFailure(compile), compile };
+    }
+    catch (error) {
+        if (isOlcxError(error)) {
+            return { ok: false, error };
+        }
+        throw error;
+    }
+}
+function isSuccessfulCompile(compile) {
+    return compile.status === "success" || compile.status === "fallback-success";
+}
+const RECOVERABLE_COMPILE_FAILURE_PATTERN = /timeout|timed out|compile timeout|time limit|upgrade required/i;
+function isRecoverableCompileFailure(outcome) {
+    if (outcome.ok)
+        return false;
+    if (outcome.error.code === "COMPILE_TIMEOUT")
+        return true;
+    if (outcome.compile?.status === "timeout")
+        return true;
+    const haystack = [
+        outcome.error.message,
+        outcome.error.hint,
+        ...summarizeCompileLogs(outcome.compile?.logs ?? []),
+        ...Object.values(outcome.error.details ?? {}).map((value) => (typeof value === "string" ? value : "")),
+    ].join("\n");
+    return RECOVERABLE_COMPILE_FAILURE_PATTERN.test(haystack);
+}
+function resolveFastFallbackConfig(config, overrides) {
+    const effective = {
+        enabled: overrides?.enabled ?? config.enabled,
+        attempts: overrides?.attempts ?? config.attempts,
+        timeoutMs: overrides?.timeoutMs ?? config.timeoutMs,
+    };
+    if (!Number.isInteger(effective.attempts) || effective.attempts < 0 || effective.attempts > MAX_FAST_FALLBACK_ATTEMPTS) {
+        throw createOlcxError({
+            code: "USER_INPUT_ERROR",
+            message: `Fast fallback attempts must be an integer from 0 to ${MAX_FAST_FALLBACK_ATTEMPTS}.`,
+            hint: "Use --fast-fallback-attempts with a value from 0 through 3.",
+        });
+    }
+    if (!Number.isInteger(effective.timeoutMs) || effective.timeoutMs <= 0) {
+        throw createOlcxError({
+            code: "USER_INPUT_ERROR",
+            message: "Fast fallback timeout must be a positive integer in milliseconds.",
+            hint: "Use --fast-fallback-timeout with a positive millisecond value.",
+        });
+    }
+    return effective;
+}
+function defaultFastCompileSession() {
+    return {
+        strategy: "request-draft",
+        compileOptions: { fastMode: true },
+        async restore() {
+            return { status: "restore-not-needed" };
+        },
+    };
+}
+async function beginFastCompileSession(backend, input) {
+    return backend.beginFastCompile ? backend.beginFastCompile(input) : defaultFastCompileSession();
+}
+function summarizeFailure(error, compile) {
+    return {
+        code: error.code,
+        message: error.message,
+        logSummary: summarizeCompileLogs(compile?.logs ?? []),
+    };
+}
+function createFallbackFailure(input) {
+    return createOlcxError({
+        code: "COMPILE_FAILED",
+        message: "Overleaf compile failed and fast/draft fallback also failed.",
+        hint: "Inspect the normal compile logs and fallback compile logs, then retry olcx compile.",
+        details: {
+            normalFailure: input.normal.ok ? undefined : summarizeFailure(input.normal.error, input.normal.compile),
+            fallbackFailure: input.fallback && !input.fallback.ok ? summarizeFailure(input.fallback.error, input.fallback.compile) : undefined,
+            restoreStatus: input.restoreStatus,
+            restoreWarning: input.restoreWarning,
+            logSummary: input.fallback && !input.fallback.ok ? summarizeCompileLogs(input.fallback.compile?.logs ?? []) : [],
+        },
+    });
+}
+export async function runCompileWithTimeout(run, timeoutMs) {
+    let timeout;
+    try {
+        return await Promise.race([
+            run(),
+            new Promise((_resolve, reject) => {
+                timeout = setTimeout(() => {
+                    reject(createOlcxError({
+                        code: "COMPILE_TIMEOUT",
+                        message: `Overleaf compile timed out after ${timeoutMs}ms.`,
+                        hint: "Increase compile.timeoutMs in .olcx/config.json or inspect the project on Overleaf.",
+                        details: { timeoutMs },
+                    }));
+                }, timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timeout !== undefined) {
+            clearTimeout(timeout);
+        }
+    }
+}
+export function createCompileFailure(compile) {
+    const code = compile.status === "timeout" ? "COMPILE_TIMEOUT" : "COMPILE_FAILED";
+    const primaryLog = compile.logs.find((log) => log.level === "error") ?? compile.logs[0];
+    const fallbackMessage = compile.error?.message ?? (compile.status === "timeout" ? "Compile timed out." : "Compile failed.");
+    const primaryMessage = primaryLog?.message ?? fallbackMessage;
+    const message = compile.status === "timeout"
+        ? `Overleaf compile timed out: ${primaryMessage}`
+        : `Overleaf compile failed: ${primaryMessage}`;
+    return createOlcxError({
+        code,
+        message,
+        hint: compile.status === "timeout"
+            ? "Increase compile.timeoutMs in .olcx/config.json or inspect the project on Overleaf."
+            : "Inspect the Overleaf compile logs before retrying.",
+        details: {
+            status: compile.status,
+            logs: compile.logs,
+            warnings: compile.warnings,
+            elapsedMs: compile.elapsedMs,
+            fallbackUsed: compile.fallbackUsed,
+            logSummary: summarizeCompileLogs(compile.logs),
+        },
+        cause: compile.error,
+    });
+}
+export async function downloadPdfAfterSuccessfulCompile(backend, input, compile) {
+    try {
+        return await backend.downloadPdf({
+            projectId: input.projectId,
+            auth: input.auth,
+        });
+    }
+    catch (error) {
+        if (isOlcxError(error)) {
+            throw error;
+        }
+        throw createOlcxError({
+            code: "COMPILE_FAILED",
+            message: "Compiled PDF could not be downloaded after a successful Overleaf compile.",
+            hint: "Retry olcx compile; if it repeats, inspect the Overleaf compile output in the browser.",
+            details: {
+                operation: "downloadPdf",
+                status: compile.status,
+                logs: compile.logs,
+                warnings: compile.warnings,
+                logSummary: summarizeCompileLogs(compile.logs),
+                causeCode: isOlcxError(error) ? error.code : "unknown",
+            },
+        });
+    }
+}
+export function summarizeCompileLogs(logs, limit = 8) {
+    return logs.slice(0, limit).map((log) => {
+        const location = [log.file, log.line].filter((entry) => entry !== undefined).join(":");
+        return [log.level, location, log.message].filter((entry) => entry !== undefined && entry !== "").join(" ");
+    });
+}
+//# sourceMappingURL=compileFlow.js.map

package/dist/compile/compileFlow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compileFlow.js","sourceRoot":"","sources":["../../src/compile/compileFlow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,0BAA0B,GAQ3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAsB,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAkB,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA8BxE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA0B;IAC7D,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE;QACjD,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1F,MAAM,OAAO,GACX,KAAK,CAAC,OAAO;QACb,CAAC,KAAK,CAAC,aAAa,IAAI,0BAA0B,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5F,MAAM,YAAY,GAAG,yBAAyB,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChG,MAAM,YAAY,GAAwB;QACxC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;QACnC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,SAAS;KACpB,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtF,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,sBAAsB,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/G,CAAC;IAED,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACjG,MAAM,MAAM,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC;QACrC,WAAW;QACX,YAAY;QACZ,OAAO;QACP,YAAY;QACZ,MAAM;QACN,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,SAAS,EAAE,YAAY,CAAC,SAAS;KAClC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAYD,KAAK,UAAU,sBAAsB,CAAC,KAAkC;IACtE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC5E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,MAAM,iCAAiC,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/G,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAE7D,OAAO;QACL,WAAW;QACX,OAAO,EAAE,OAAO,CAAC,YAAY;QAC7B,eAAe,EAAE,OAAO,CAAC,YAAY;QACrC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC;AACJ,CAAC;AAYD,KAAK,UAAU,eAAe,CAAC,KAA2B;IACxD,IAAI,OAA8C,CAAC;IACnD,IAAI,aAAa,GAAG,qBAAqB,CAAC;IAC1C,IAAI,cAAkC,CAAC;IACvC,IAAI,QAAyC,CAAC;IAE9C,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE;YACrD,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,SAAS;YACvC,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI;SAC9B,CAAC,CAAC;QAEH,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,aAAa,GAAwB;gBACzC,GAAG,KAAK,CAAC,YAAY;gBACrB,GAAG,OAAO,CAAC,cAAc;gBACzB,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC;YACF,QAAQ,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAChF,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC;QACD,QAAQ,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;gBACxC,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;gBAC/B,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;YACnC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,aAAa,GAAG,gBAAgB,CAAC;gBACjC,cAAc,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,EAAE,EAAE,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,gDAAgD,cAAc,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,sBAAsB,CAAC;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,qBAAqB,CAAC;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ;QACR,aAAa;QACb,cAAc;KACf,CAAC,CAAC;AACL,CAAC;AAMD,KAAK,UAAU,eAAe,CAC5B,OAAwB,EACxB,KAA0B,EAC1B,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;QACrF,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAsB;IACjD,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,kBAAkB,CAAC;AAC/E,CAAC;AAED,MAAM,mCAAmC,GAAG,gEAAgE,CAAC;AAE7G,SAAS,2BAA2B,CAAC,OAA4B;IAC/D,IAAI,OAAO,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,QAAQ,GAAG;QACf,OAAO,CAAC,KAAK,CAAC,OAAO;QACrB,OAAO,CAAC,KAAK,CAAC,IAAI;QAClB,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QACpD,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KACvG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,mCAAmC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,yBAAyB,CAChC,MAAgD,EAChD,SAAmD;IAEnD,MAAM,SAAS,GAAG;QAChB,OAAO,EAAE,SAAS,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO;QAC7C,QAAQ,EAAE,SAAS,EAAE,QAAQ,IAAI,MAAM,CAAC,QAAQ;QAChD,SAAS,EAAE,SAAS,EAAE,SAAS,IAAI,MAAM,CAAC,SAAS;KACpD,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,GAAG,0BAA0B,EAAE,CAAC;QACvH,MAAM,eAAe,CAAC;YACpB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,uDAAuD,0BAA0B,GAAG;YAC7F,IAAI,EAAE,6DAA6D;SACpE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,eAAe,CAAC;YACpB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,mEAAmE;YAC5E,IAAI,EAAE,gEAAgE;SACvE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,yBAAyB;IAChC,OAAO;QACL,QAAQ,EAAE,eAAe;QACzB,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;QAClC,KAAK,CAAC,OAAO;YACX,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,OAAwB,EAAE,KAA0B;IACzF,OAAO,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,yBAAyB,EAAE,CAAC;AAClG,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAgB,EAAE,OAAuB;IACjE,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,oBAAoB,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAK9B;IACC,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,8DAA8D;QACvE,IAAI,EAAE,qFAAqF;QAC3F,OAAO,EAAE;YACP,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;YACvG,eAAe,EACb,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YACnH,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,UAAU,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;SACjH;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAiC,EACjC,SAAiB;IAEjB,IAAI,OAAkD,CAAC;IAEvD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,GAAG,EAAE;YACL,IAAI,OAAO,CAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBAC9C,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;oBACxB,MAAM,CACJ,eAAe,CAAC;wBACd,IAAI,EAAE,iBAAiB;wBACvB,OAAO,EAAE,oCAAoC,SAAS,KAAK;wBAC3D,IAAI,EAAE,qFAAqF;wBAC3F,OAAO,EAAE,EAAE,SAAS,EAAE;qBACvB,CAAC,CACH,CAAC;gBACJ,CAAC,EAAE,SAAS,CAAC,CAAC;YAChB,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAsB;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACjF,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC5H,MAAM,cAAc,GAAG,UAAU,EAAE,OAAO,IAAI,eAAe,CAAC;IAC9D,MAAM,OAAO,GACX,OAAO,CAAC,MAAM,KAAK,SAAS;QAC1B,CAAC,CAAC,+BAA+B,cAAc,EAAE;QACjD,CAAC,CAAC,4BAA4B,cAAc,EAAE,CAAC;IAEnD,OAAO,eAAe,CAAC;QACrB,IAAI;QACJ,OAAO;QACP,IAAI,EACF,OAAO,CAAC,MAAM,KAAK,SAAS;YAC1B,CAAC,CAAC,qFAAqF;YACvF,CAAC,CAAC,oDAAoD;QAC1D,OAAO,EAAE;YACP,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,UAAU,EAAE,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC;SAC/C;QACD,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,OAAwB,EACxB,KAA0B,EAC1B,OAAsB;IAEtB,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,WAAW,CAAC;YAC/B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,eAAe,CAAC;YACpB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,2EAA2E;YACpF,IAAI,EAAE,wFAAwF;YAC9F,OAAO,EAAE;gBACP,SAAS,EAAE,aAAa;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC;gBAC9C,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;aACvD;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAuB,EAAE,KAAK,GAAG,CAAC;IACrE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/compile/pdfOutput.d.ts

@@ -0,0 +1,12 @@
+export interface PdfOutputTarget {
+    projectRoot: string;
+    relativePath: string;
+    absolutePath: string;
+}
+export interface PdfOutputWriteResult {
+    relativePath: string;
+    absolutePath: string;
+    bytesWritten: number;
+}
+export declare function resolvePdfOutputTarget(projectRoot: string, pdfPath: string): PdfOutputTarget;
+export declare function writePdfOutput(target: PdfOutputTarget, bytes: Uint8Array): Promise<PdfOutputWriteResult>;

package/dist/compile/pdfOutput.js

@@ -0,0 +1,64 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, relative, resolve, sep, win32 } from "node:path";
+import { createOlcxError, isOlcxError } from "../errors.js";
+export function resolvePdfOutputTarget(projectRoot, pdfPath) {
+    const normalized = normalizeSafeRelativePdfPath(pdfPath);
+    const resolvedRoot = resolve(projectRoot);
+    const absolutePath = resolve(resolvedRoot, ...normalized.split("/"));
+    const relativeToRoot = relative(resolvedRoot, absolutePath);
+    if (relativeToRoot === ".." || relativeToRoot.startsWith(`..${sep}`) || isAbsolute(relativeToRoot)) {
+        throw unsafePdfPathError(pdfPath);
+    }
+    return {
+        projectRoot: resolvedRoot,
+        relativePath: normalized,
+        absolutePath,
+    };
+}
+export async function writePdfOutput(target, bytes) {
+    try {
+        await mkdir(dirname(target.absolutePath), { recursive: true });
+        await writeFile(target.absolutePath, bytes);
+    }
+    catch (error) {
+        if (isOlcxError(error)) {
+            throw error;
+        }
+        throw createOlcxError({
+            code: "IO_ERROR",
+            message: `Failed to write compiled PDF to ${target.relativePath}.`,
+            hint: "Check directory permissions and retry olcx compile.",
+            details: { path: target.relativePath },
+            cause: error,
+        });
+    }
+    return {
+        relativePath: target.relativePath,
+        absolutePath: target.absolutePath,
+        bytesWritten: bytes.byteLength,
+    };
+}
+function normalizeSafeRelativePdfPath(pdfPath) {
+    if (typeof pdfPath !== "string" || pdfPath.trim().length === 0) {
+        throw unsafePdfPathError(pdfPath);
+    }
+    const trimmed = pdfPath.trim();
+    if (isAbsolute(trimmed) || win32.isAbsolute(trimmed)) {
+        throw unsafePdfPathError(pdfPath);
+    }
+    const normalized = trimmed.replace(/\\/g, "/");
+    const segments = normalized.split("/").filter((segment) => segment.length > 0 && segment !== ".");
+    if (segments.length === 0 || segments.some((segment) => segment === "..")) {
+        throw unsafePdfPathError(pdfPath);
+    }
+    return segments.join("/");
+}
+function unsafePdfPathError(pdfPath) {
+    return createOlcxError({
+        code: "USER_INPUT_ERROR",
+        message: "PDF output path must be a safe relative path inside the project root.",
+        hint: "Use a path like build/overleaf/main.pdf or pass --pdf with a project-relative path.",
+        details: { path: pdfPath },
+    });
+}
+//# sourceMappingURL=pdfOutput.js.map

package/dist/compile/pdfOutput.js.map

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

package/dist/config/ignoreRules.d.ts

@@ -0,0 +1,5 @@
+export declare const REQUIRED_GITIGNORE_ENTRIES: readonly [".olcx/auth.local.json", ".olcx/*.local.json", ".olcx/*.secret.json", ".olcx/state/", "build/overleaf/", "*.aux", "*.log", "*.synctex.gz"];
+export declare function ensureGitignoreEntries(projectRoot: string): Promise<{
+    changed: boolean;
+    added: string[];
+}>;

package/dist/config/ignoreRules.js

@@ -0,0 +1,53 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+export const REQUIRED_GITIGNORE_ENTRIES = [
+    ".olcx/auth.local.json",
+    ".olcx/*.local.json",
+    ".olcx/*.secret.json",
+    ".olcx/state/",
+    "build/overleaf/",
+    "*.aux",
+    "*.log",
+    "*.synctex.gz",
+];
+const MARKER_COMMENT = "# Local paper-project state created by olcx.";
+export async function ensureGitignoreEntries(projectRoot) {
+    const path = join(projectRoot, ".gitignore");
+    const existing = await readExistingGitignore(path);
+    const lines = existing.content.split(/\r?\n/);
+    const existingEntries = new Set(lines.map((line) => line.trim()).filter((line) => line.length > 0));
+    const added = REQUIRED_GITIGNORE_ENTRIES.filter((entry) => !existingEntries.has(entry));
+    if (added.length === 0) {
+        return { changed: false, added: [] };
+    }
+    const newline = existing.newline;
+    const blocks = [];
+    if (existing.content.length > 0) {
+        blocks.push(ensureEndsWithNewline(existing.content, newline));
+        if (!existing.content.endsWith("\n") && !existing.content.endsWith("\r\n")) {
+            blocks.push(newline);
+        }
+    }
+    if (existing.content.length > 0 && !existing.content.endsWith(`${newline}${newline}`)) {
+        blocks.push(newline);
+    }
+    blocks.push([MARKER_COMMENT, ...added].join(newline), newline);
+    await writeFile(path, blocks.join(""), "utf8");
+    return { changed: true, added };
+}
+async function readExistingGitignore(path) {
+    try {
+        const content = await readFile(path, "utf8");
+        return { content, newline: content.includes("\r\n") ? "\r\n" : "\n" };
+    }
+    catch (error) {
+        if (typeof error === "object" && error !== null && error.code === "ENOENT") {
+            return { content: "", newline: "\n" };
+        }
+        throw error;
+    }
+}
+function ensureEndsWithNewline(content, newline) {
+    return content.endsWith("\n") || content.endsWith("\r\n") ? content : `${content}${newline}`;
+}
+//# sourceMappingURL=ignoreRules.js.map

package/dist/config/ignoreRules.js.map

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

package/dist/config/overleafProject.d.ts

@@ -0,0 +1,9 @@
+import { type OverleafBaseUrl } from "./types.js";
+export interface ParsedProjectReference {
+    projectId: string;
+    projectUrl?: string;
+    overleaf: {
+        baseUrl: OverleafBaseUrl;
+    };
+}
+export declare function parseProjectReference(value: string): ParsedProjectReference;

package/dist/config/overleafProject.js

@@ -0,0 +1,61 @@
+import { createOlcxError } from "../errors.js";
+import { DEFAULT_OVERLEAF_BASE_URL } from "./types.js";
+const PROJECT_ID_PATTERN = /^[A-Za-z0-9_-]{6,128}$/;
+export function parseProjectReference(value) {
+    const input = value.trim();
+    if (input.length === 0) {
+        throw invalidProjectReference("Overleaf project reference is required.");
+    }
+    if (looksLikeUrl(input)) {
+        return parseProjectUrl(input);
+    }
+    if (!PROJECT_ID_PATTERN.test(input)) {
+        throw invalidProjectReference("Overleaf project id is invalid.");
+    }
+    return { projectId: input, overleaf: { baseUrl: DEFAULT_OVERLEAF_BASE_URL } };
+}
+function parseProjectUrl(input) {
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch {
+        throw invalidProjectReference("Overleaf project URL is invalid.");
+    }
+    const host = url.hostname.toLowerCase();
+    const baseUrl = baseUrlForProjectHost(host);
+    const segments = url.pathname.split("/").filter(Boolean);
+    const projectId = segments[1] ?? "";
+    if (url.protocol !== "https:" ||
+        url.username.length > 0 ||
+        url.password.length > 0 ||
+        baseUrl === undefined ||
+        segments.length !== 2 ||
+        segments[0] !== "project" ||
+        !PROJECT_ID_PATTERN.test(projectId)) {
+        throw invalidProjectReference("Overleaf project URL must look like https://www.overleaf.com/project/<id> or https://cn.overleaf.com/project/<id>.");
+    }
+    return {
+        projectId,
+        projectUrl: `${baseUrl}/project/${projectId}`,
+        overleaf: { baseUrl },
+    };
+}
+function baseUrlForProjectHost(host) {
+    if (host === "cn.overleaf.com")
+        return "https://cn.overleaf.com";
+    if (host === "www.overleaf.com" || host === "overleaf.com")
+        return "https://www.overleaf.com";
+    return undefined;
+}
+function looksLikeUrl(input) {
+    return /^[A-Za-z][A-Za-z0-9+.-]*:/.test(input);
+}
+function invalidProjectReference(message) {
+    return createOlcxError({
+        code: "USER_INPUT_ERROR",
+        message,
+        hint: "Pass --project with an Overleaf project id, https://www.overleaf.com/project/<id>, or https://cn.overleaf.com/project/<id> URL.",
+    });
+}
+//# sourceMappingURL=overleafProject.js.map

package/dist/config/overleafProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overleafProject.js","sourceRoot":"","sources":["../../src/config/overleafProject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAwB,MAAM,YAAY,CAAC;AAU7E,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,uBAAuB,CAAC,yCAAyC,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,uBAAuB,CAAC,iCAAiC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,EAAE,CAAC;AAChF,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,GAAQ,CAAC;IAEb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,uBAAuB,CAAC,kCAAkC,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEpC,IACE,GAAG,CAAC,QAAQ,KAAK,QAAQ;QACzB,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACvB,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACvB,OAAO,KAAK,SAAS;QACrB,QAAQ,CAAC,MAAM,KAAK,CAAC;QACrB,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS;QACzB,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EACnC,CAAC;QACD,MAAM,uBAAuB,CAC3B,oHAAoH,CACrH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS;QACT,UAAU,EAAE,GAAG,OAAO,YAAY,SAAS,EAAE;QAC7C,QAAQ,EAAE,EAAE,OAAO,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,yBAAyB,CAAC;IACjE,IAAI,IAAI,KAAK,kBAAkB,IAAI,IAAI,KAAK,cAAc;QAAE,OAAO,0BAA0B,CAAC;IAC9F,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAe;IAC9C,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,kBAAkB;QACxB,OAAO;QACP,IAAI,EAAE,iIAAiI;KACxI,CAAC,CAAC;AACL,CAAC"}

package/dist/config/projectConfig.d.ts

@@ -0,0 +1,6 @@
+import { type ProjectConfig } from "./types.js";
+export declare function getProjectConfigPath(projectRoot: string): string;
+export declare function readProjectConfig(projectRoot: string): Promise<ProjectConfig>;
+export declare function writeProjectConfig(projectRoot: string, config: ProjectConfig): Promise<void>;
+export declare function validateProjectConfig(value: unknown): ProjectConfig;
+export declare function summarizeProjectConfig(config: ProjectConfig): Record<string, unknown>;