@elytracms/core 0.0.6

package/dist/export-sync/node.js

@@ -0,0 +1,101 @@
+import { existsSync, readdirSync, watch as fsWatch } from 'node:fs';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { WORKSPACE_CONFIG_FILES } from '@elytracms/core/studio-core';
+import { extractManifestCandidates, isManifestFile, MANIFEST_IGNORED_DIRECTORIES, } from './manifest-host';
+/**
+ * Node-only implementations for the manifest push (EC-147) and workspace init
+ * (EC-154): the real filesystem {@link ManifestHost}, the `node:fs` watch
+ * driver, and the dynamic-import {@link WorkspaceConfigHost}. Lives behind the
+ * `@elytracms/core/export-sync/node` subpath — NOT re-exported from the package root —
+ * because the studio bundles the root barrel via `@elytracms/core/plugins` and must stay
+ * browser-safe.
+ */
+function walk(rootAbs, relative, out) {
+    const entries = readdirSync(join(rootAbs, relative), { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name.startsWith('.'))
+            continue;
+        const relPath = relative === '' ? entry.name : `${relative}/${entry.name}`;
+        if (entry.isDirectory()) {
+            if (MANIFEST_IGNORED_DIRECTORIES.has(entry.name))
+                continue;
+            walk(rootAbs, relPath, out);
+        }
+        else if (isManifestFile(entry.name)) {
+            out.push(relPath);
+        }
+    }
+}
+/**
+ * The real {@link ManifestHost}: recursive fs walk + dynamic `import()`. Loading a
+ * `.manifest.ts` module requires a TypeScript-capable runtime (the CLI is expected to
+ * run under `tsx` or Node type stripping in the host repo); compiled `.manifest.js` /
+ * `.manifest.mjs` modules load under plain Node.
+ */
+export function createNodeManifestHost() {
+    return {
+        listManifestFiles(root) {
+            const out = [];
+            walk(root, '', out);
+            return out.sort();
+        },
+        async loadManifestCandidates(root, file) {
+            // Cache-bust so watch mode re-imports edited modules instead of the stale copy.
+            const url = `${pathToFileURL(join(root, file)).href}?t=${Date.now()}`;
+            const moduleExports = await import(url);
+            return extractManifestCandidates(moduleExports);
+        },
+    };
+}
+/**
+ * The real {@link WorkspaceConfigHost} (EC-154): probes the conventional
+ * `elytra.config.*` names under the host-repo root and loads modules with
+ * dynamic `import()`, exactly like manifest discovery. Loading the `.ts`
+ * variants requires a TypeScript-capable runtime (`tsx` / Node type stripping);
+ * compiled `.js`/`.mjs` configs load under plain Node.
+ */
+export function createNodeWorkspaceConfigHost() {
+    async function loadModule(absolutePath) {
+        // Cache-bust so repeated CLI runs in one process re-import edited modules.
+        const url = `${pathToFileURL(absolutePath).href}?t=${Date.now()}`;
+        return import(url);
+    }
+    return {
+        async loadConfig(root) {
+            for (const file of WORKSPACE_CONFIG_FILES) {
+                const absolute = join(root, file);
+                if (!existsSync(absolute))
+                    continue;
+                return { file, moduleExports: await loadModule(absolute) };
+            }
+            return undefined;
+        },
+        loadSchemaModule(root, modulePath) {
+            return loadModule(join(root, modulePath));
+        },
+    };
+}
+/** The real watch driver: `node:fs` recursive watch (no external watcher dependency). */
+export function createFsWatchDriver() {
+    return {
+        watch(root, onEvent) {
+            let resolveDone;
+            const done = new Promise((resolve) => {
+                resolveDone = resolve;
+            });
+            const watcher = fsWatch(root, { recursive: true }, (_eventType, filename) => {
+                if (filename !== null)
+                    onEvent({ path: filename.toString().split('\\').join('/') });
+            });
+            return {
+                close() {
+                    watcher.close();
+                    resolveDone();
+                },
+                done,
+            };
+        },
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/export-sync/node.js.map

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

package/dist/export-sync/push.d.ts

@@ -0,0 +1,76 @@
+import type { ComponentManifest } from '@elytracms/core/component-registry';
+import type { ManifestHost } from './manifest-host';
+/**
+ * The host-repo manifest discovery + validation pass (EC-147, vision AD-2).
+ * Component manifests are code-owned (defined in TS next to the components), so
+ * there is no longer a DB copy to push to: `builder push` is now a validate-only
+ * command that discovers manifest modules in the host repo, validates them with
+ * the component-registry validation (EC-011: invalid/duplicate ids) plus structural
+ * checks, and reports any problems.
+ *
+ * Failure semantics mirror `runPull`: every problem is a structured {@link PushIssue},
+ * never a throw. CI mode (`--ci`) fails the run (exit non-zero) on any issue. The
+ * discovery here is shared with `builder check` (EC-148) so both see the exact same
+ * local manifest set, validated the exact same way.
+ */
+export type PushIssueCode = 'load-error' | 'invalid-manifest' | 'duplicate-id' | 'invalid-id';
+/** A file-level, structured validation failure (CI output is built from these). */
+export interface PushIssue {
+    code: PushIssueCode;
+    severity: 'error';
+    message: string;
+    /** Root-relative manifest module path, when the issue is attributable to a file. */
+    file?: string;
+    componentId?: string;
+}
+export interface PushOptions {
+    /** Host-repo scan root. */
+    root: string;
+    /** Non-interactive mode: any issue fails the run (exit non-zero). */
+    ci?: boolean;
+}
+export interface DiscoveredManifestFile {
+    file: string;
+    ids: string[];
+}
+export interface PushResult {
+    files: DiscoveredManifestFile[];
+    /** Component ids discovered and validated this run. */
+    discovered: string[];
+    issues: PushIssue[];
+    ok: boolean;
+}
+/**
+ * Structural validation of a single exported candidate (the manifest module contract:
+ * every export must be a manifest). Returns human-readable problems; empty = valid.
+ * Id well-formedness and cross-file duplicates are checked by `ComponentRegistry`
+ * (EC-011) afterwards.
+ */
+export declare function validateManifestCandidate(value: unknown): string[];
+/** The machine-parseable issue line format shared by `push` and `check` CI output. */
+export declare function formatPushIssue(issue: PushIssue): string;
+/**
+ * Everything `runPush` and `runCheck` (EC-148) know about the host repo's
+ * component manifests: the conflict-free, structurally valid manifest set plus
+ * any discovery/validation issues. Shared so push and the CI check see the exact
+ * same local manifest set, validated the exact same way.
+ */
+export interface ManifestDiscovery {
+    files: DiscoveredManifestFile[];
+    /** id → the validated live manifest for every conflict-free, structurally valid module. */
+    manifests: Map<string, ComponentManifest>;
+    /** id → stable JSON payload (deterministic change detection). */
+    payloads: Map<string, string>;
+    /** Load + validation issues; non-empty means the local view is INCOMPLETE. */
+    issues: PushIssue[];
+}
+/**
+ * Discover, load, and validate the host repo's manifest modules (steps 1–3):
+ * fs/module problems become `load-error`, structural problems `invalid-manifest`,
+ * and EC-011 registry validation contributes `duplicate-id`/`invalid-id`. Never throws.
+ */
+export declare function discoverManifests(host: ManifestHost, root: string): Promise<ManifestDiscovery>;
+/** Run a push (discover + validate). Returns a structured result and never throws. */
+export declare function runPush(host: ManifestHost, io: {
+    log(line: string): void;
+}, options: PushOptions): Promise<PushResult>;

package/dist/export-sync/push.js

@@ -0,0 +1,197 @@
+import { ComponentRegistry, isPrimitive, namespaceOf } from '@elytracms/core/component-registry';
+import { assertPropFieldDef, fieldDefSchema, fieldValueValidator } from '@elytracms/core/cms-core';
+import { stableJson } from './core';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Structural validation of a single exported candidate (the manifest module contract:
+ * every export must be a manifest). Returns human-readable problems; empty = valid.
+ * Id well-formedness and cross-file duplicates are checked by `ComponentRegistry`
+ * (EC-011) afterwards.
+ */
+export function validateManifestCandidate(value) {
+    if (!isRecord(value)) {
+        return [
+            'Export is not a component manifest object (every export of a *.manifest.* module must be a manifest or an array of manifests).',
+        ];
+    }
+    const problems = [];
+    const id = value.id;
+    if (typeof id !== 'string' || id.length === 0) {
+        problems.push('Manifest is missing a string "id".');
+    }
+    else {
+        if (typeof value.namespace !== 'string' || value.namespace !== namespaceOf(id)) {
+            problems.push(`Manifest "namespace" ("${String(value.namespace)}") does not match the id's namespace ("${namespaceOf(id)}").`);
+        }
+        if (isPrimitive(id)) {
+            problems.push(`"${id}" is under base.primitives.* — platform primitives are platform-owned and cannot be declared in a host repo.`);
+        }
+    }
+    if (!isRecord(value.props)) {
+        problems.push('Manifest "props" must be a record of prop field-defs.');
+    }
+    else {
+        for (const [name, spec] of Object.entries(value.props)) {
+            // EC-190: a prop is a `FieldDef` minus `name` (the record key IS the name).
+            // It must parse as a field-def, its `default` must satisfy the field's own
+            // value validator, and document-only attrs (`filterable`/`unique`) are flagged.
+            if (!isRecord(spec)) {
+                problems.push(`Prop "${name}" must be a field-def object.`);
+                continue;
+            }
+            const parsed = fieldDefSchema.safeParse({ ...spec, name });
+            if (!parsed.success) {
+                problems.push(`Prop "${name}" is not a valid field-def (expected a cms-core FieldDef shape).`);
+                continue;
+            }
+            const field = parsed.data;
+            for (const issue of assertPropFieldDef(field))
+                problems.push(issue.message);
+            if (spec.default !== undefined && !fieldValueValidator(field)(spec.default)) {
+                problems.push(`Default value for prop "${name}" does not satisfy its own field-def.`);
+            }
+        }
+    }
+    if (!Array.isArray(value.slots)) {
+        problems.push('Manifest "slots" must be an array of slot specs.');
+    }
+    else {
+        for (const slot of value.slots) {
+            if (!isRecord(slot) || typeof slot.name !== 'string' || slot.name.length === 0) {
+                problems.push('Every slot spec needs a non-empty string "name".');
+                break;
+            }
+        }
+    }
+    if (value.iterate !== undefined) {
+        const iterate = value.iterate;
+        const slotNames = Array.isArray(value.slots)
+            ? value.slots.filter(isRecord).map((s) => s.name)
+            : [];
+        // EC-190 DD7: the iterated items value (an array) has NO static field-def type,
+        // so `itemsProp` is no longer a *declared* prop — it rides node.props undeclared.
+        // Only the item slot must resolve to an existing slot.
+        if (!isRecord(iterate) ||
+            typeof iterate.itemsProp !== 'string' ||
+            iterate.itemsProp.length === 0 ||
+            typeof iterate.itemSlot !== 'string' ||
+            !slotNames.includes(iterate.itemSlot)) {
+            problems.push('"iterate" must name an items prop and reference an existing item slot.');
+        }
+    }
+    return problems;
+}
+/** The machine-parseable issue line format shared by `push` and `check` CI output. */
+export function formatPushIssue(issue) {
+    const where = [issue.file, issue.componentId].filter(Boolean).join(' ');
+    return `  error [${issue.code}]${where ? ` ${where}` : ''} — ${issue.message}`;
+}
+/**
+ * Discover, load, and validate the host repo's manifest modules (steps 1–3):
+ * fs/module problems become `load-error`, structural problems `invalid-manifest`,
+ * and EC-011 registry validation contributes `duplicate-id`/`invalid-id`. Never throws.
+ */
+export async function discoverManifests(host, root) {
+    const issues = [];
+    const files = [];
+    /** id → file of first registration (for duplicate/file attribution). */
+    const fileOf = new Map();
+    const valid = [];
+    // 1. Discover + load manifest modules; a failing module is a file-level issue.
+    let fileList = [];
+    try {
+        fileList = [...(await host.listManifestFiles(root))].sort();
+    }
+    catch (cause) {
+        issues.push({
+            code: 'load-error',
+            severity: 'error',
+            message: `Manifest discovery failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+        });
+    }
+    for (const file of fileList) {
+        let candidates;
+        try {
+            candidates = [...(await host.loadManifestCandidates(root, file))];
+        }
+        catch (cause) {
+            issues.push({
+                code: 'load-error',
+                severity: 'error',
+                file,
+                message: `Manifest module failed to load: ${cause instanceof Error ? cause.message : String(cause)}`,
+            });
+            continue;
+        }
+        const ids = [];
+        for (const candidate of candidates) {
+            const problems = validateManifestCandidate(candidate);
+            if (problems.length > 0) {
+                const componentId = isRecord(candidate) && typeof candidate.id === 'string' ? candidate.id : undefined;
+                for (const message of problems) {
+                    issues.push({
+                        code: 'invalid-manifest',
+                        severity: 'error',
+                        file,
+                        ...(componentId ? { componentId } : {}),
+                        message,
+                    });
+                }
+                continue;
+            }
+            // Structurally verified above; the manifest interface is satisfied.
+            const manifest = candidate;
+            ids.push(manifest.id);
+            if (!fileOf.has(manifest.id))
+                fileOf.set(manifest.id, file);
+            valid.push(manifest);
+        }
+        files.push({ file, ids });
+    }
+    // 2. EC-011 registry validation over the structurally valid set: invalid ids and
+    //    duplicate ids come from the same ComponentRegistry that guards authoring.
+    const registry = new ComponentRegistry(valid);
+    const excluded = new Set();
+    for (const issue of registry.issues) {
+        excluded.add(issue.componentId);
+        const firstFile = fileOf.get(issue.componentId);
+        issues.push({
+            code: issue.code === 'duplicate-id' ? 'duplicate-id' : 'invalid-id',
+            severity: 'error',
+            ...(firstFile ? { file: firstFile } : {}),
+            componentId: issue.componentId,
+            message: issue.code === 'duplicate-id'
+                ? `Duplicate component id "${issue.componentId}" across manifest modules (first declared in ${firstFile ?? 'unknown'}).`
+                : issue.message,
+        });
+    }
+    // 3. Collect the conflict-free manifests + deterministic payloads (change detection).
+    const payloads = new Map();
+    const manifests = new Map();
+    for (const manifest of valid) {
+        if (excluded.has(manifest.id) || manifests.has(manifest.id))
+            continue;
+        manifests.set(manifest.id, manifest);
+        payloads.set(manifest.id, stableJson({ id: manifest.id, namespace: manifest.namespace }));
+    }
+    return { files, manifests, payloads, issues };
+}
+/** Run a push (discover + validate). Returns a structured result and never throws. */
+export async function runPush(host, io, options) {
+    const { files, manifests, issues } = await discoverManifests(host, options.root);
+    io.log(`Push (${options.root}): ${manifests.size} manifest(s) in ${files.length} file(s)${issues.length ? ` — ${issues.length} issue(s)` : ''}.`);
+    for (const issue of issues)
+        io.log(formatPushIssue(issue));
+    const discovered = [...manifests.keys()].sort();
+    if (issues.length > 0) {
+        io.log(options.ci
+            ? 'CI mode: validation failed.'
+            : `Validated ${discovered.length} manifest(s) with ${issues.length} issue(s).`);
+        return { files, discovered, issues, ok: false };
+    }
+    io.log(`Validated ${discovered.length} manifest(s).`);
+    return { files, discovered, issues, ok: true };
+}
+//# sourceMappingURL=push.js.map

package/dist/export-sync/push.js.map

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

package/dist/export-sync/registry-sync-client.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Shared CLI ↔ builder HTTP transport (EC-157). The `builder check` / `builder
+ * typegen` snapshot endpoint is served by the builder's Convex deployment
+ * (`convex/http.ts` + `convex/sync.ts`), authenticated with the EC-150 Bearer CLI
+ * tokens. This module fixes the endpoint layout, the token header, the request
+ * helper, and the structured error contract that the snapshot exchange uses.
+ *
+ * Component manifests are code-owned (defined in TS next to the components) and are
+ * no longer mirrored in builder persistence — there is no manifest push/list/sync
+ * client. What remains here is the shared snapshot transport.
+ */
+/** Env var the CLI reads the sync token from when `--token` is not passed. */
+export declare const SYNC_TOKEN_ENV = "ELYTRA_SYNC_TOKEN";
+/** Header carrying the sync token: `Authorization: Bearer <token>`. */
+export declare const REGISTRY_SYNC_TOKEN_HEADER = "authorization";
+/** Resolve the sync token: explicit flag wins, then `ELYTRA_SYNC_TOKEN`. */
+export declare function resolveSyncToken(flagValue: string | undefined, env: Record<string, string | undefined>): string | undefined;
+/** Endpoint layout the builder implements (EC-157 — Convex HTTP action in `convex/sync.ts`). */
+export declare function registrySyncEndpoints(baseUrl: string, projectId: string): {
+    snapshot: string;
+};
+/**
+ * One structured problem inside a builder error response — mirrors the CLI's
+ * issue granularity (per-item validation failures keep their component id).
+ */
+export interface RegistrySyncErrorIssue {
+    code: string;
+    message: string;
+    componentId?: string;
+}
+/**
+ * The structured error body every builder sync endpoint returns on failure (EC-157):
+ * auth failures and validation problems are data, never opaque 500s.
+ */
+export interface RegistrySyncErrorBody {
+    error: {
+        code: string;
+        message: string;
+        issues?: RegistrySyncErrorIssue[];
+    };
+}
+/** A failed CLI ↔ builder exchange — reported as a structured `transport` issue. */
+export declare class RegistrySyncTransportError extends Error {
+    /** HTTP status of the builder response, when one was received. */
+    readonly status?: number;
+    /** Structured issues from the builder error body, when it sent any. */
+    readonly issues?: RegistrySyncErrorIssue[];
+    constructor(message: string, options?: {
+        status?: number;
+        issues?: RegistrySyncErrorIssue[];
+    });
+}
+/**
+ * One authenticated JSON exchange with a builder sync endpoint. Used by the HTTP
+ * builder source (`builder-source.ts`) to fetch the typegen/check snapshot. Non-OK
+ * responses become {@link RegistrySyncTransportError}s carrying the builder's
+ * structured error body (code, message, per-item issues) when one was returned.
+ */
+export declare function registrySyncRequest<T>(fetchImpl: typeof fetch, url: string, method: 'GET' | 'POST', token: string | undefined, body?: unknown): Promise<T>;

package/dist/export-sync/registry-sync-client.js

@@ -0,0 +1,97 @@
+/**
+ * Shared CLI ↔ builder HTTP transport (EC-157). The `builder check` / `builder
+ * typegen` snapshot endpoint is served by the builder's Convex deployment
+ * (`convex/http.ts` + `convex/sync.ts`), authenticated with the EC-150 Bearer CLI
+ * tokens. This module fixes the endpoint layout, the token header, the request
+ * helper, and the structured error contract that the snapshot exchange uses.
+ *
+ * Component manifests are code-owned (defined in TS next to the components) and are
+ * no longer mirrored in builder persistence — there is no manifest push/list/sync
+ * client. What remains here is the shared snapshot transport.
+ */
+/** Env var the CLI reads the sync token from when `--token` is not passed. */
+export const SYNC_TOKEN_ENV = 'ELYTRA_SYNC_TOKEN';
+/** Header carrying the sync token: `Authorization: Bearer <token>`. */
+export const REGISTRY_SYNC_TOKEN_HEADER = 'authorization';
+/** Resolve the sync token: explicit flag wins, then `ELYTRA_SYNC_TOKEN`. */
+export function resolveSyncToken(flagValue, env) {
+    return flagValue ?? env[SYNC_TOKEN_ENV];
+}
+/** Endpoint layout the builder implements (EC-157 — Convex HTTP action in `convex/sync.ts`). */
+export function registrySyncEndpoints(baseUrl, projectId) {
+    const base = `${baseUrl.replace(/\/$/, '')}/api/projects/${projectId}/registry-sync`;
+    return {
+        snapshot: `${base}/snapshot`,
+    };
+}
+function parseErrorBody(value) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const error = value.error;
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    const { code, message, issues } = error;
+    if (typeof code !== 'string' || typeof message !== 'string')
+        return undefined;
+    return {
+        code,
+        message,
+        ...(Array.isArray(issues)
+            ? {
+                issues: issues.filter((issue) => typeof issue === 'object' &&
+                    issue !== null &&
+                    typeof issue.code === 'string' &&
+                    typeof issue.message === 'string'),
+            }
+            : {}),
+    };
+}
+/** A failed CLI ↔ builder exchange — reported as a structured `transport` issue. */
+export class RegistrySyncTransportError extends Error {
+    /** HTTP status of the builder response, when one was received. */
+    status;
+    /** Structured issues from the builder error body, when it sent any. */
+    issues;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = 'RegistrySyncTransportError';
+        if (options.status !== undefined)
+            this.status = options.status;
+        if (options.issues !== undefined)
+            this.issues = options.issues;
+    }
+}
+/**
+ * One authenticated JSON exchange with a builder sync endpoint. Used by the HTTP
+ * builder source (`builder-source.ts`) to fetch the typegen/check snapshot. Non-OK
+ * responses become {@link RegistrySyncTransportError}s carrying the builder's
+ * structured error body (code, message, per-item issues) when one was returned.
+ */
+export async function registrySyncRequest(fetchImpl, url, method, token, body) {
+    const headers = { 'content-type': 'application/json' };
+    if (token)
+        headers[REGISTRY_SYNC_TOKEN_HEADER] = `Bearer ${token}`;
+    let response;
+    try {
+        response = await fetchImpl(url, {
+            method,
+            headers,
+            ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+        });
+    }
+    catch (cause) {
+        throw new RegistrySyncTransportError(`Builder unreachable at ${url}: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    if (!response.ok) {
+        const errorBody = parseErrorBody(await response.json().catch(() => undefined));
+        const issueLines = (errorBody?.issues ?? [])
+            .map((issue) => `[${issue.code}]${issue.componentId ? ` ${issue.componentId}` : ''} ${issue.message}`)
+            .join('; ');
+        throw new RegistrySyncTransportError(`Builder responded ${response.status} for ${method} ${url}${errorBody ? ` — ${errorBody.code}: ${errorBody.message}` : '.'}${issueLines ? ` (${issueLines})` : ''}`, {
+            status: response.status,
+            ...(errorBody?.issues ? { issues: errorBody.issues } : {}),
+        });
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=registry-sync-client.js.map

package/dist/export-sync/registry-sync-client.js.map

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

package/dist/export-sync/sync.d.ts

@@ -0,0 +1,47 @@
+import type { ExportInput, ExportMode, GeneratedFile } from './core';
+import type { ExportIssue } from './validate';
+/**
+ * Pull / sync / drift (EC-110–112). The CLI's job is provider-neutral: a {@link ExportSource}
+ * yields the canonical model (from Convex in production, from a fixture offline); the pull
+ * validates, generates, and writes — or, in validate/drift modes, only reports. CI runs this
+ * before `next build` and fails on validation errors or drift.
+ */
+/** Provider-neutral source of the canonical model (Convex adapter in production; fixture offline). */
+export interface ExportSource {
+    loadInput(mode: ExportMode): Promise<ExportInput> | ExportInput;
+}
+/** Injected file IO so the pull is fully testable (in-memory in tests, fs in the real bin). */
+export interface FileIO {
+    read(path: string): string | undefined;
+    write(path: string, contents: string): void;
+    log(message: string): void;
+}
+export type DriftStatus = 'added' | 'changed' | 'unchanged';
+export interface DriftEntry {
+    path: string;
+    status: DriftStatus;
+}
+export interface PullOptions {
+    mode: ExportMode;
+    /** Validate + report only; never write files. */
+    validateOnly?: boolean;
+    /** Compute drift against the existing repo files; never write. */
+    checkDrift?: boolean;
+    /** Treat any error-severity validation issue (or, in drift mode, any drift) as failure. */
+    failOnError?: boolean;
+}
+export interface PullResult {
+    mode: ExportMode;
+    issues: ExportIssue[];
+    files: GeneratedFile[];
+    drift: DriftEntry[];
+    /** Paths actually written (empty in validate/drift modes). */
+    wrote: string[];
+    /** Overall success (respects failOnError). */
+    ok: boolean;
+}
+/**
+ * Run a pull. Returns a structured result and never throws; validation issues are data. Writes
+ * files only when not in validate/drift mode and (if failOnError) there are no error issues.
+ */
+export declare function runPull(source: ExportSource, io: FileIO, options: PullOptions): Promise<PullResult>;

package/dist/export-sync/sync.js

@@ -0,0 +1,47 @@
+import { generateExport } from './generate';
+import { isExportable, validateExport } from './validate';
+function computeDrift(files, io) {
+    return files.map((file) => {
+        const existing = io.read(file.path);
+        const status = existing === undefined ? 'added' : existing === file.contents ? 'unchanged' : 'changed';
+        return { path: file.path, status };
+    });
+}
+/**
+ * Run a pull. Returns a structured result and never throws; validation issues are data. Writes
+ * files only when not in validate/drift mode and (if failOnError) there are no error issues.
+ */
+export async function runPull(source, io, options) {
+    const input = await source.loadInput(options.mode);
+    const issues = validateExport(input);
+    const exportable = isExportable(issues);
+    const errorCount = issues.filter((i) => i.severity === 'error').length;
+    io.log(`Pull (${options.mode}): ${issues.length} validation issue(s)${errorCount ? ` — ${errorCount} error(s)` : ''}.`);
+    // Validation gate: with --fail-on-error a broken graph never produces output (EC-111/112).
+    if (options.failOnError && !exportable) {
+        for (const issue of issues.filter((i) => i.severity === 'error'))
+            io.log(`  error [${issue.code}] ${issue.message}`);
+        return { mode: options.mode, issues, files: [], drift: [], wrote: [], ok: false };
+    }
+    const files = generateExport(input);
+    if (options.validateOnly) {
+        return { mode: options.mode, issues, files, drift: [], wrote: [], ok: exportable };
+    }
+    const drift = computeDrift(files, io);
+    if (options.checkDrift) {
+        const changed = drift.filter((d) => d.status !== 'unchanged');
+        for (const d of changed)
+            io.log(`  drift ${d.status}: ${d.path}`);
+        io.log(`Drift: ${changed.length} of ${files.length} file(s) out of sync.`);
+        const ok = (!options.failOnError || changed.length === 0) && exportable;
+        return { mode: options.mode, issues, files, drift, wrote: [], ok };
+    }
+    const wrote = [];
+    for (const file of files) {
+        io.write(file.path, file.contents);
+        wrote.push(file.path);
+    }
+    io.log(`Wrote ${wrote.length} file(s).`);
+    return { mode: options.mode, issues, files, drift, wrote, ok: exportable };
+}
+//# sourceMappingURL=sync.js.map