overleaf-codex 0.1.0-rc.1

package/dist/commands/compile.js

@@ -0,0 +1,73 @@
+import { redactSensitive } from "../cli-behavior.js";
+import { compileProject, } from "../compile/compileFlow.js";
+export async function runCompileCommand(input) {
+    return compileProject(input);
+}
+export function formatCompileSuccess(result) {
+    const lines = [
+        "olcx compile",
+        `Status: ${result.status}`,
+        `PDF: ${result.pdfPath}`,
+        `Bytes: ${result.bytesWritten}`,
+        `Elapsed: ${result.elapsedMs}ms`,
+        `Warnings: ${result.warnings.length}`,
+    ];
+    if (result.fallbackUsed) {
+        lines.push("Fallback: fast/draft");
+    }
+    if (result.warnings.length > 0) {
+        lines.push(...result.warnings.map((warning) => `- ${warning}`));
+    }
+    lines.push(`Next: open ${result.pdfPath}`);
+    return redactSensitive(`${lines.join("\n")}\n`);
+}
+export function formatCompileFailure(error) {
+    const lines = [`Error: ${error.message}`];
+    const logSummary = readLogSummary(error.details);
+    const normalFailure = readFailureSummary(error.details, "normalFailure");
+    const fallbackFailure = readFailureSummary(error.details, "fallbackFailure");
+    const restoreStatus = readStringDetail(error.details, "restoreStatus");
+    const restoreWarning = readStringDetail(error.details, "restoreWarning");
+    if (normalFailure)
+        lines.push(`Normal compile failure: ${normalFailure}`);
+    if (fallbackFailure)
+        lines.push(`Fast/draft fallback failure: ${fallbackFailure}`);
+    if (restoreStatus)
+        lines.push(`Restore: ${restoreStatus}`);
+    if (restoreWarning)
+        lines.push(`Restore warning: ${restoreWarning}`);
+    if (logSummary.length > 0) {
+        lines.push("Compile log summary:", ...logSummary.map((entry) => `- ${entry}`));
+    }
+    lines.push(`Next: ${error.hint ?? "Fix the compile issue and retry olcx compile."}`);
+    return redactSensitive(`${lines.join("\n")}\n`);
+}
+function readLogSummary(details) {
+    if (!details || typeof details !== "object" || !("logSummary" in details)) {
+        return [];
+    }
+    const logSummary = details.logSummary;
+    if (!Array.isArray(logSummary)) {
+        return [];
+    }
+    return logSummary.filter((entry) => typeof entry === "string");
+}
+function readStringDetail(details, key) {
+    if (!details || typeof details !== "object" || !(key in details)) {
+        return undefined;
+    }
+    const value = details[key];
+    return typeof value === "string" ? value : undefined;
+}
+function readFailureSummary(details, key) {
+    if (!details || typeof details !== "object" || !(key in details)) {
+        return undefined;
+    }
+    const value = details[key];
+    if (!value || typeof value !== "object") {
+        return undefined;
+    }
+    const message = value.message;
+    return typeof message === "string" ? message : undefined;
+}
+//# sourceMappingURL=compile.js.map

package/dist/commands/compile.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,11 @@
+import type { ExitCode } from "../errors.js";
+export interface GetDoctorOutputOptions {
+    cwd: string;
+    nodeVersion?: string;
+    backendAvailable?: boolean;
+}
+export interface DoctorCommandOutput {
+    exitCode: ExitCode;
+    output: string;
+}
+export declare function getDoctorOutput(options: GetDoctorOutputOptions): Promise<DoctorCommandOutput>;

package/dist/commands/doctor.js

@@ -0,0 +1,9 @@
+import { formatDoctorReport, runDoctorDiagnostics } from "../diagnostics/doctor.js";
+export async function getDoctorOutput(options) {
+    const report = await runDoctorDiagnostics(options);
+    return {
+        exitCode: report.exitCode,
+        output: formatDoctorReport(report),
+    };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAcpF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA+B;IACnE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/commands/endpoint.d.ts

@@ -0,0 +1,23 @@
+import { type ExitCode } from "../cli-behavior.js";
+import { type FetchLike } from "../endpoint/overleafEndpoint.js";
+export interface EndpointCommandRuntime {
+    fetchImpl?: FetchLike;
+    nowMs?: () => number;
+}
+export declare function getEndpointStatusOutput(input: {
+    cwd: string;
+}): Promise<string>;
+export declare function setEndpoint(input: {
+    cwd: string;
+    endpoint: string;
+}): Promise<string>;
+export declare function testEndpoint(input: {
+    cwd: string;
+    apply?: boolean;
+    timeoutMs?: number;
+    fetchImpl?: FetchLike;
+    nowMs?: () => number;
+}): Promise<{
+    output: string;
+    exitCode: ExitCode;
+}>;

package/dist/commands/endpoint.js

@@ -0,0 +1,69 @@
+import { EXIT_CODES, createOlcxError } from "../cli-behavior.js";
+import { findProjectRoot } from "../config/projectRoot.js";
+import { readProjectConfig, writeProjectConfig } from "../config/projectConfig.js";
+import { endpointAliasFromBaseUrl, formatEndpointProbeResult, resolveEndpointInput, selectFastestAvailableEndpoint, testOverleafEndpoints, } from "../endpoint/overleafEndpoint.js";
+export async function getEndpointStatusOutput(input) {
+    const projectRoot = await findProjectRoot(input.cwd);
+    const config = await readProjectConfig(projectRoot);
+    const alias = endpointAliasFromBaseUrl(config.overleaf.baseUrl);
+    return [
+        "olcx endpoint status",
+        `Current: ${alias} (${config.overleaf.baseUrl})`,
+        "Probe: not run",
+    ].join("\n") + "\n";
+}
+export async function setEndpoint(input) {
+    const endpoint = resolveEndpointInput(input.endpoint);
+    const projectRoot = await findProjectRoot(input.cwd);
+    const config = await readProjectConfig(projectRoot);
+    await writeProjectConfig(projectRoot, {
+        ...config,
+        overleaf: { baseUrl: endpoint.baseUrl },
+    });
+    return [
+        "olcx endpoint set",
+        `Set: ${endpoint.alias} (${endpoint.baseUrl})`,
+    ].join("\n") + "\n";
+}
+export async function testEndpoint(input) {
+    const timeoutMs = input.timeoutMs ?? 5000;
+    if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) {
+        throw createOlcxError({
+            code: "USER_INPUT_ERROR",
+            message: "Endpoint probe timeout must be a positive integer in milliseconds.",
+            hint: "Use --timeout with a value greater than 0.",
+            details: { timeoutMs },
+        });
+    }
+    const projectRoot = await findProjectRoot(input.cwd);
+    const config = await readProjectConfig(projectRoot);
+    const currentAlias = endpointAliasFromBaseUrl(config.overleaf.baseUrl);
+    const results = await testOverleafEndpoints({
+        timeoutMs,
+        fetchImpl: input.fetchImpl,
+        now: input.nowMs,
+    });
+    const fastest = selectFastestAvailableEndpoint(results);
+    const lines = [
+        "olcx endpoint test",
+        `Current: ${currentAlias} (${config.overleaf.baseUrl})`,
+        "Results:",
+        ...results.map(formatEndpointProbeResult),
+    ];
+    if (fastest === undefined) {
+        lines.push("Applied: no", "Error: No Overleaf endpoint is reachable.", "Next: Check network access, proxy, firewall, or retry without --apply.");
+        return { output: `${lines.join("\n")}\n`, exitCode: EXIT_CODES.NETWORK_ERROR };
+    }
+    if (input.apply === true) {
+        await writeProjectConfig(projectRoot, {
+            ...config,
+            overleaf: { baseUrl: fastest.baseUrl },
+        });
+        lines.push(`Applied: ${fastest.alias}`);
+    }
+    else {
+        lines.push("Applied: no", `Next: olcx endpoint set ${fastest.alias}`);
+    }
+    return { output: `${lines.join("\n")}\n`, exitCode: EXIT_CODES.SUCCESS };
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/commands/endpoint.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,14 @@
+export interface InitProjectOptions {
+    cwd: string;
+    project: string;
+    vscode?: boolean;
+}
+export interface InitProjectResult {
+    projectRoot: string;
+    projectId: string;
+    pdfPath: string;
+    configCreated: boolean;
+    gitignoreChanged: boolean;
+    vscodeChanged: boolean;
+}
+export declare function initProject(options: InitProjectOptions): Promise<InitProjectResult>;

package/dist/commands/init.js

@@ -0,0 +1,48 @@
+import { createOlcxError, isOlcxError } from "../errors.js";
+import { ensureGitignoreEntries } from "../config/ignoreRules.js";
+import { parseProjectReference } from "../config/overleafProject.js";
+import { readProjectConfig, writeProjectConfig } from "../config/projectConfig.js";
+import { findProjectRoot } from "../config/projectRoot.js";
+import { createDefaultProjectConfig } from "../config/types.js";
+import { ensureVsCodeConfig } from "../config/vscode.js";
+export async function initProject(options) {
+    const projectRef = parseProjectReference(options.project);
+    const projectRoot = await findProjectRoot(options.cwd);
+    const { config, created } = await readOrCreateConfig(projectRoot, projectRef);
+    const gitignore = await ensureGitignoreEntries(projectRoot);
+    const vscode = await ensureVsCodeConfig(projectRoot, {
+        pdfPath: config.pdfPath,
+        rootDocument: config.rootDocument,
+    });
+    return {
+        projectRoot,
+        projectId: config.projectId,
+        pdfPath: config.pdfPath,
+        configCreated: created,
+        gitignoreChanged: gitignore.changed,
+        vscodeChanged: vscode.changed,
+    };
+}
+async function readOrCreateConfig(projectRoot, projectRef) {
+    try {
+        const existing = await readProjectConfig(projectRoot);
+        if (existing.projectId !== projectRef.projectId) {
+            throw createOlcxError({
+                code: "PROJECT_CONFIG_INVALID",
+                message: "This repository is already bound to a different Overleaf project.",
+                hint: "Use the existing binding or edit .olcx/config.json intentionally.",
+                details: { path: ".olcx/config.json" },
+            });
+        }
+        return { config: existing, created: false };
+    }
+    catch (error) {
+        if (!isOlcxError(error) || error.code !== "PROJECT_CONFIG_NOT_FOUND") {
+            throw error;
+        }
+    }
+    const config = createDefaultProjectConfig(projectRef);
+    await writeProjectConfig(projectRoot, config);
+    return { config, created: true };
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAA+B,MAAM,8BAA8B,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAsB,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAiBzD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE;QACnD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW;QACX,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,OAAO;QACtB,gBAAgB,EAAE,SAAS,CAAC,OAAO;QACnC,aAAa,EAAE,MAAM,CAAC,OAAO;KAC9B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,WAAmB,EACnB,UAAkC;IAElC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAEtD,IAAI,QAAQ,CAAC,SAAS,KAAK,UAAU,CAAC,SAAS,EAAE,CAAC;YAChD,MAAM,eAAe,CAAC;gBACpB,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,mEAAmE;gBAC5E,IAAI,EAAE,mEAAmE;gBACzE,OAAO,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;aACvC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;YACrE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,4 @@
+export interface GetStatusOutputOptions {
+    cwd: string;
+}
+export declare function getStatusOutput(options: GetStatusOutputOptions): Promise<string>;

package/dist/commands/status.js

@@ -0,0 +1,5 @@
+import { collectProjectStatus, formatProjectStatus } from "../diagnostics/status.js";
+export async function getStatusOutput(options) {
+    return formatProjectStatus(await collectProjectStatus(options));
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMrF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA+B;IACnE,OAAO,mBAAmB,CAAC,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/commands/sync.d.ts

@@ -0,0 +1,26 @@
+import { type OverleafBackend, type OverleafBackendFactory } from "../backend/index.js";
+import { type SyncPlan } from "../sync/types.js";
+export interface SyncProjectOptions {
+    cwd: string;
+    dryRun?: boolean;
+    backend?: OverleafBackend;
+    createBackend?: OverleafBackendFactory;
+    env?: Record<string, string | undefined>;
+    now?: () => Date;
+}
+export interface SyncProjectResult {
+    projectRoot: string;
+    dryRun: boolean;
+    plan: SyncPlan;
+    output: string;
+}
+export declare function syncProject(options: SyncProjectOptions): Promise<SyncProjectResult>;
+export declare function formatSyncPlanOutput(result: SyncProjectResult): string;
+export declare function formatSyncConflictFailure(input: {
+    conflicts: {
+        path: string;
+        reason: string;
+    }[];
+    dryRun: boolean;
+    reportWritten: boolean;
+}): string;

package/dist/commands/sync.js

@@ -0,0 +1,139 @@
+import { resolveProjectAuth } from "../auth/projectAuth.js";
+import { createOlcliOverleafBackend, } from "../backend/index.js";
+import { redactSensitive } from "../cli-behavior.js";
+import { readProjectConfig } from "../config/projectConfig.js";
+import { findProjectRoot } from "../config/projectRoot.js";
+import { createOlcxError } from "../errors.js";
+import { applySyncPlan } from "../sync/apply.js";
+import { createConflictReport } from "../sync/conflicts.js";
+import { createSyncPlan } from "../sync/plan.js";
+import { createLocalSnapshot, createRemoteSnapshot } from "../sync/snapshot.js";
+import { buildNextSyncState, clearConflictReport, readSyncState, writeConflictReport, writeSyncState, } from "../sync/state.js";
+import { CONFLICT_REPORT_PATH, SYNC_STATE_PATH } from "../sync/types.js";
+export async function syncProject(options) {
+    const now = options.now ?? (() => new Date());
+    const createdAt = now().toISOString();
+    const dryRun = options.dryRun === true;
+    const projectRoot = await findProjectRoot(options.cwd);
+    const config = await readProjectConfig(projectRoot);
+    const auth = await resolveProjectAuth(projectRoot, { env: options.env, now });
+    const state = await readSyncState(projectRoot, { now });
+    const backend = options.backend ??
+        (options.createBackend ?? createOlcliOverleafBackend)({ baseUrl: config.overleaf.baseUrl });
+    const localFiles = await createLocalSnapshot({
+        projectRoot,
+        userIgnorePatterns: config.sync.ignore,
+    });
+    const remoteFiles = await createRemoteSnapshot({
+        backend,
+        projectId: config.projectId,
+        auth,
+        userIgnorePatterns: config.sync.ignore,
+    });
+    const plan = createSyncPlan({
+        projectId: config.projectId,
+        createdAt,
+        dryRun,
+        state,
+        localFiles,
+        remoteFiles,
+        userIgnorePatterns: config.sync.ignore,
+        allowDeletes: false,
+    });
+    if (plan.conflicts.length > 0) {
+        let reportWritten = false;
+        if (!dryRun) {
+            await writeConflictReport(projectRoot, createConflictReport({
+                generatedAt: createdAt,
+                conflicts: plan.conflicts,
+                watchPaused: true,
+            }));
+            reportWritten = true;
+        }
+        throw createOlcxError({
+            code: "SYNC_CONFLICT",
+            message: `Sync paused because ${plan.conflicts.length} conflict(s) were detected.`,
+            hint: "Review the listed files, then run olcx sync --dry-run.",
+            details: {
+                conflicts: summarizeConflicts(plan.conflicts),
+                ...(reportWritten ? { reportPath: CONFLICT_REPORT_PATH } : {}),
+            },
+        });
+    }
+    if (!dryRun) {
+        const applyResult = await applySyncPlan({
+            projectRoot,
+            backend,
+            projectId: config.projectId,
+            auth,
+            plan,
+        });
+        await writeSyncState(projectRoot, buildNextSyncState({
+            previous: state,
+            plan,
+            appliedAt: createdAt,
+            uploadResults: applyResult.uploaded,
+        }));
+        await clearConflictReport(projectRoot);
+    }
+    const result = {
+        projectRoot,
+        dryRun,
+        plan,
+        output: "",
+    };
+    result.output = formatSyncPlanOutput(result);
+    return result;
+}
+export function formatSyncPlanOutput(result) {
+    const uploadPaths = operationPaths(result.plan, "upload");
+    const downloadPaths = operationPaths(result.plan, "download");
+    const lines = [
+        result.dryRun ? "olcx sync --dry-run" : "olcx sync",
+        `Plan: upload ${result.plan.summary.upload}, download ${result.plan.summary.download}, unchanged ${result.plan.summary.unchanged}, ignored ${result.plan.summary.ignored}`,
+    ];
+    if (result.dryRun) {
+        appendPathSection(lines, "Uploads:", uploadPaths);
+        appendPathSection(lines, "Downloads:", downloadPaths);
+        lines.push("No files changed.");
+        return redactSensitive(`${lines.join("\n")}\n`);
+    }
+    appendPathSection(lines, "Uploaded:", uploadPaths);
+    appendPathSection(lines, "Downloaded:", downloadPaths);
+    if (uploadPaths.length === 0 && downloadPaths.length === 0) {
+        lines.push("No file changes to apply.");
+    }
+    lines.push(`State: ${SYNC_STATE_PATH}`, "Next: olcx compile");
+    return redactSensitive(`${lines.join("\n")}\n`);
+}
+export function formatSyncConflictFailure(input) {
+    const lines = [
+        `Error: Sync paused because ${input.conflicts.length} conflict(s) were detected.`,
+        "Conflicts:",
+        ...input.conflicts.map((conflict) => `- ${conflict.path} (${conflict.reason})`),
+        "Next: review the listed files, then run olcx sync --dry-run.",
+    ];
+    if (!input.dryRun && input.reportWritten) {
+        lines.push(`Conflict report: ${CONFLICT_REPORT_PATH}`);
+    }
+    return redactSensitive(`${lines.join("\n")}\n`);
+}
+function operationPaths(plan, type) {
+    return plan.operations
+        .filter((operation) => operation.type === type)
+        .map((operation) => operation.path)
+        .sort();
+}
+function appendPathSection(lines, title, paths) {
+    if (paths.length === 0) {
+        return;
+    }
+    lines.push(title, ...paths.map((path) => `- ${path}`));
+}
+function summarizeConflicts(conflicts) {
+    return conflicts.map((conflict) => ({
+        path: conflict.path,
+        reason: conflict.reason,
+    }));
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/commands/watch.d.ts

@@ -0,0 +1,28 @@
+import { type OverleafBackend, type OverleafBackendFactory } from "../backend/index.js";
+import { type PreparedWatchProject, type WatchCycleInput, type WatchCycleResult } from "../watch/workflow.js";
+import type { WatchAdapter, WatchCommandResult, WatchSignalRuntime } from "../watch/types.js";
+export interface RunWatchCommandInput {
+    cwd: string;
+    debounceMs: number;
+    backend?: OverleafBackend;
+    createBackend?: OverleafBackendFactory;
+    env?: Record<string, string | undefined>;
+    now?: () => Date;
+    watchAdapter?: WatchAdapter;
+    signals?: WatchSignalRuntime;
+    writeOut: (value: string) => void;
+    writeErr: (value: string) => void;
+    prepareProject?: (input: {
+        cwd: string;
+        env?: Record<string, string | undefined>;
+        now?: () => Date;
+    }) => Promise<PreparedWatchProject>;
+    runCycle?: (input: WatchCycleInput) => Promise<WatchCycleResult>;
+}
+export declare function runWatchCommand(input: RunWatchCommandInput): Promise<WatchCommandResult>;
+export declare function formatWatchStarted(input: {
+    projectRoot: string;
+    debounceMs: number;
+}): string;
+export declare function formatWatchCycleSuccess(result: WatchCycleResult): string;
+export declare function formatWatchFailure(error: unknown): string;

package/dist/commands/watch.js

@@ -0,0 +1,124 @@
+import { EXIT_CODES, isOlcxError, redactSensitive } from "../cli-behavior.js";
+import { createWatchQueue } from "../watch/queue.js";
+import { createChokidarWatchAdapter, createWatchIgnoredPredicate } from "../watch/watcher.js";
+import { prepareWatchProject, runWatchCycle, } from "../watch/workflow.js";
+export async function runWatchCommand(input) {
+    const prepare = input.prepareProject ?? prepareWatchProject;
+    const cycle = input.runCycle ?? runWatchCycle;
+    const adapter = input.watchAdapter ?? createChokidarWatchAdapter();
+    const signals = input.signals ?? processSignals();
+    const prepared = await prepare({ cwd: input.cwd, env: input.env, now: input.now });
+    const ignored = createWatchIgnoredPredicate({
+        projectRoot: prepared.projectRoot,
+        userIgnorePatterns: prepared.config.sync.ignore,
+    });
+    let resolved = false;
+    let resolveDone;
+    const done = new Promise((resolve) => {
+        resolveDone = resolve;
+    });
+    let lastExitCode = EXIT_CODES.SUCCESS;
+    let paused = false;
+    const queue = createWatchQueue({
+        debounceMs: input.debounceMs,
+        run: async () => {
+            input.writeOut("Running: olcx sync\n");
+            const result = await cycle({
+                cwd: prepared.projectRoot,
+                backend: input.backend,
+                createBackend: input.createBackend,
+                env: input.env,
+                now: input.now,
+            });
+            input.writeOut(formatWatchCycleSuccess(result));
+        },
+        onFailure: async (error) => {
+            paused = true;
+            lastExitCode = isOlcxError(error) ? error.exitCode : EXIT_CODES.INTERNAL_ERROR;
+            input.writeErr(formatWatchFailure(error));
+        },
+    });
+    const handle = await adapter.watch({
+        projectRoot: prepared.projectRoot,
+        ignored,
+        onChange: (event) => {
+            queue.trigger(event);
+        },
+        onError: (error) => {
+            queue.pause(error);
+            paused = true;
+            lastExitCode = EXIT_CODES.INTERNAL_ERROR;
+            input.writeErr(formatWatchFailure(error));
+        },
+    });
+    const cleanupCallbacks = [];
+    async function shutdown() {
+        if (resolved)
+            return;
+        resolved = true;
+        for (const cleanup of cleanupCallbacks.splice(0))
+            cleanup();
+        await queue.shutdown();
+        await handle.close();
+        input.writeOut("Stopped: olcx watch\n");
+        const lastError = queue.status().lastError;
+        resolveDone(lastError === undefined ? { exitCode: lastExitCode, paused } : { exitCode: lastExitCode, paused, lastError });
+    }
+    cleanupCallbacks.push(signals.on("SIGINT", shutdown));
+    cleanupCallbacks.push(signals.on("SIGTERM", shutdown));
+    input.writeOut(formatWatchStarted({ projectRoot: prepared.projectRoot, debounceMs: input.debounceMs }));
+    return done;
+}
+export function formatWatchStarted(input) {
+    return redactSensitive([
+        "olcx watch",
+        `Watching: ${input.projectRoot}`,
+        `Debounce: ${input.debounceMs}ms`,
+        "Next: edit local files; press Ctrl-C to stop.",
+    ].join("\n") + "\n");
+}
+export function formatWatchCycleSuccess(result) {
+    return redactSensitive([
+        "Synced: olcx sync",
+        `Compiled PDF: ${result.compile.pdfPath}`,
+        `Bytes: ${result.compile.bytesWritten}`,
+        "Waiting for changes.",
+    ].join("\n") + "\n");
+}
+export function formatWatchFailure(error) {
+    if (isOlcxError(error)) {
+        const phase = readWatchPhase(error.details);
+        return redactSensitive([`Error: Watch paused after ${phase} failed: ${error.message}`, `Next: ${nextStepForFailure(error.code)}`].join("\n") + "\n");
+    }
+    const message = error instanceof Error ? error.message : "Unexpected watch failure.";
+    return redactSensitive(`Error: Watch paused after workflow failed: ${message}\nNext: stop olcx watch, inspect the error, then restart olcx watch.\n`);
+}
+function readWatchPhase(details) {
+    if (details && typeof details === "object" && details.watchPhase === "sync")
+        return "sync";
+    if (details && typeof details === "object" && details.watchPhase === "compile") {
+        return "compile";
+    }
+    return "workflow";
+}
+function nextStepForFailure(code) {
+    if (code === "SYNC_CONFLICT" || code === "SYNC_UNSAFE_OPERATION") {
+        return "review conflicts, run olcx sync --dry-run, run olcx sync after it is clean, then restart olcx watch.";
+    }
+    if (code === "COMPILE_FAILED" || code === "COMPILE_TIMEOUT") {
+        return "run olcx compile, fix the compile issue, then restart olcx watch.";
+    }
+    return "fix the reported issue, then restart olcx watch.";
+}
+function processSignals() {
+    return {
+        on(signal, listener) {
+            const wrapped = () => {
+                void listener();
+            };
+            process.once(signal, wrapped);
+            return () => process.off(signal, wrapped);
+        },
+    };
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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