@sequenceholdings/pipeline-spec 0.1.0

package/dist/graph.js

@@ -0,0 +1,546 @@
+import { z } from 'zod';
+import { fullSourceShapeEqual, postgresDestinationKey } from './snapshot-transport.js';
+import { canonicalJson } from './hash.js';
+import { resolveCatalogBinding } from './catalog-binding.js';
+import { columnMapSchema } from './columns.js';
+import { checkServingProjectionCompatibility } from './serving-compatibility.js';
+import { feedBronzeTable, ingestionSourceIdentity } from './bodies/ingestion.js';
+import { transformationOutputCatalog } from './resolve.js';
+import { consumedReferences, softColumns, triggerTargets, unresolvedSchemaRefs, upstreamStages, } from './graph-references.js';
+import { checkServingSatisfiesOrmContract, ormContractCatalogKey, } from './orm-satisfies.js';
+import { nearMisses } from './suggestions.js';
+/**
+ * Offline repo-level graph validation: a Pipeline's stages form a DAG through
+ * declared inputs/outputs. `validateSpecGraph` resolves references, enforces
+ * single-writer-per-physical-asset, rejects cycles, and runs column checks —
+ * with ZERO I/O, so the CI gate can run without network or database.
+ */
+export const GRAPH_FINDING_CODES = [
+    'snapshot_source_shape_mismatch',
+    'duplicate_stage_id',
+    'single_writer_violation',
+    'unresolved_reference',
+    'unresolved_trigger_target',
+    'cycle_detected',
+    'column_not_produced',
+    'projection_column_missing',
+    'projection_incompatible',
+    'sync_mode_incompatible',
+    'no_inputs_declared',
+    'unresolved_schema_ref',
+    'orm_contract_unavailable',
+    'orm_contract_hash_mismatch',
+    'orm_contract_pk_mismatch',
+    'orm_contract_incompatible',
+    'serving_source_catalog_mismatch',
+];
+/**
+ * Cross-Pipeline references resolve against a registry **asset export**
+ * supplied by the caller — keeps the SDK offline-capable. Keys are logical
+ * asset ids (`<stage>.<asset>`, e.g. `billing-silver.silver.coding_usage`).
+ *
+ * Evolution contract: `schema_version` is the explicit format version — the
+ * registry bumps it on breaking export changes and consumers reject versions
+ * they don't understand. Objects stay STRICT in v1 (unknown keys are a
+ * version bump, never silently ignored), so producers can't leak fields the
+ * gate doesn't validate.
+ */
+export const externalAssetsExportSchema = z.strictObject({
+    schema_version: z.literal(1),
+    assets: z.record(z.string().min(1), z.strictObject({
+        columns: columnMapSchema.optional(),
+    })),
+});
+function transformationPhysicalAsset({ spec, asset, deployCatalog, deployTarget, }) {
+    // Environment-aware callers pass the deploy catalog so an unpinned writer
+    // (`banksouth.gold.loans`) collides with a writer that restates
+    // `config.catalog: banksouth`. Offline validate omits it and keys only
+    // pinned stages as `<catalog>.<asset>`.
+    if (typeof deployCatalog === 'string' && deployCatalog.length > 0) {
+        return `${transformationOutputCatalog(spec, deployCatalog, deployTarget)}.${asset}`;
+    }
+    const catalog = resolveCatalogBinding({
+        binding: spec.config?.catalog,
+        deployTarget,
+    });
+    return catalog ? `${catalog}.${asset}` : asset;
+}
+function producedAssets(spec, deployCatalog, deployTarget, bindings) {
+    switch (spec.type) {
+        case 'ingestion':
+            // Feeds are schemaless at the contract level (bronze is raw). Their
+            // single-writer key is the CATALOG-QUALIFIED bronze FQN
+            // (`src_<source>.bronze.<feed>`) because per-source catalogs are
+            // ACCOUNT-level assets shared across deployments. The qualified name
+            // is the real shared namespace. Serving physicals stay
+            // deployment-relative (`public.x`). Transformation physicals are
+            // keyed below — unqualified unless `config.catalog` pins a parallel UC
+            // namespace, or fully qualified when the deploy catalog is supplied.
+            return Object.keys(spec.feeds).map((feed) => ({
+                id: `${spec.stage}.${feed}`,
+                stage: spec.stage,
+                physical: feedBronzeTable({ source: ingestionSourceIdentity(spec), feed }),
+            }));
+        case 'transformation':
+            return Object.entries(spec.outputs).map(([asset, output]) => {
+                const columns = softColumns(output.columns);
+                const physical = transformationPhysicalAsset({ spec, asset, deployCatalog, deployTarget });
+                return {
+                    id: `${spec.stage}.${asset}`,
+                    stage: spec.stage,
+                    physical,
+                    ...(output.write_scope ? { writeScope: output.write_scope } : {}),
+                    ...(columns !== undefined ? { columns } : {}),
+                };
+            });
+        case 'serving': {
+            const privateOnly = spec.expose.public_view_access === 'orm_only';
+            const columns = softColumns(spec.projection.columns);
+            const transport = spec.transport;
+            const [exposureSchema, exposureRelation] = spec.expose.view.split('.');
+            if (!exposureSchema || !exposureRelation)
+                throw new Error('serving exposure must be schema.relation');
+            // Private serving contributes an ORM writer claim without publishing
+            // the sync naming key as a consumable asset.
+            const physicals = privateOnly ? [] : transport?.kind === 'postgres_snapshot_landing_v1'
+                ? [transport.landing, transport.buffer, { schema: exposureSchema, relation: exposureRelation }]
+                    .map(target => postgresDestinationKey({
+                    bindingId: bindings?.[transport.binding]?.bindingId ?? transport.binding,
+                    database: bindings?.[transport.binding]?.database ?? transport.database, ...target,
+                }))
+                : [spec.expose.view, ...(spec.expose.reporting_table ? [spec.expose.reporting_table] : [])];
+            const binding = spec.orm_binding ?? spec.satisfies;
+            if (binding)
+                for (const environment of deployTarget ? [deployTarget] : spec.environments) {
+                    physicals.push(`orm:${canonicalJson([environment, binding.namespace, binding.table])}`);
+                }
+            return physicals.map((physical, index) => ({
+                id: `${spec.stage}.${index === 0 && !privateOnly ? spec.expose.view : physical}`, stage: spec.stage, physical,
+                ...(columns !== undefined ? { columns } : {}),
+            }));
+        }
+    }
+}
+/**
+ * Every `after:` target must resolve to a stage — in-repo, or present in the
+ * external asset export (a stage "exists externally" when any exported asset
+ * key carries its `<stage>.` prefix). A typo'd target would otherwise be
+ * silently dropped by cycle detection and produce an undeployable schedule.
+ */
+function checkTriggerTargets(spec, stageIds, externalStages, findings) {
+    for (const target of triggerTargets(spec)) {
+        if (stageIds.has(target) || externalStages.has(target))
+            continue;
+        const suggestions = nearMisses(target, [...stageIds, ...externalStages]);
+        findings.push({
+            code: 'unresolved_trigger_target',
+            severity: 'error',
+            stage: spec.stage,
+            asset: target,
+            suggestions,
+            message: `'${spec.stage}' trigger.after references stage '${target}', which no stage in this Pipeline or the asset export declares` +
+                (suggestions.length > 0 ? ` — did you mean: ${suggestions.join(', ')}?` : ''),
+        });
+    }
+}
+function findCycle(stages) {
+    const byId = new Map(stages.map((spec) => [spec.stage, spec]));
+    const visiting = new Set();
+    const done = new Set();
+    const stack = [];
+    const visit = (id) => {
+        if (done.has(id))
+            return null;
+        if (visiting.has(id))
+            return [...stack.slice(stack.indexOf(id)), id];
+        const spec = byId.get(id);
+        if (!spec)
+            return null;
+        visiting.add(id);
+        stack.push(id);
+        for (const upstream of upstreamStages(spec)) {
+            const cycle = visit(upstream);
+            if (cycle)
+                return cycle;
+        }
+        stack.pop();
+        visiting.delete(id);
+        done.add(id);
+        return null;
+    };
+    for (const spec of stages) {
+        const cycle = visit(spec.stage);
+        if (cycle)
+            return cycle;
+    }
+    return null;
+}
+/**
+ * Asset graph nodes + single-writer-per-physical-asset. Logical ids differ
+ * (`<stage>.<asset>`) but physical names share one namespace; two writers of
+ * `gold.loans` in the same catalog would clobber each other. A transformation
+ * that pins `config.catalog` is keyed `<catalog>.<asset>` so parallel source
+ * catalogs can share an asset name. When `options.catalog` is the deploy
+ * catalog, unpinned writers are keyed the same way so they collide with a
+ * restated `config.catalog` equal to that target. The registry-wired check
+ * (M6) extends this across Pipelines per deployment.
+ */
+function collectAssets(stages, findings, deployCatalog, deployTarget, bindings) {
+    const assetsById = new Map();
+    const writersByPhysical = new Map();
+    for (const spec of stages) {
+        for (const asset of producedAssets(spec, deployCatalog, deployTarget, bindings)) {
+            assetsById.set(asset.id, asset);
+            const writers = writersByPhysical.get(asset.physical) ?? [];
+            writers.push(asset);
+            writersByPhysical.set(asset.physical, writers);
+        }
+    }
+    for (const [physical, writers] of writersByPhysical) {
+        if (writers.length > 1 && !haveDisjointCompatibleScopes(writers)) {
+            findings.push({
+                code: 'single_writer_violation',
+                severity: 'error',
+                asset: physical,
+                consumers: writers.map((writer) => writer.stage),
+                message: `physical asset '${physical}' is declared by multiple stages: ${writers
+                    .map((writer) => `'${writer.stage}'`)
+                    .join(', ')} — writers must have disjoint scopes on the same column and identical schemas, or exactly one writer`,
+            });
+        }
+    }
+    return assetsById;
+}
+function haveDisjointCompatibleScopes(writers) {
+    const first = writers[0];
+    if (!first?.writeScope || !first.columns)
+        return false;
+    const signature = (columns) => canonicalJson(Object.fromEntries(Object.entries(columns).map(([name, column]) => [name, {
+            type: column.type,
+            nullable: column.nullable,
+            key: column.key,
+            ...(column.domain ? { domain: column.domain } : {}),
+        }])));
+    const firstSignature = signature(first.columns);
+    const scopes = new Set();
+    for (const writer of writers) {
+        const scope = writer.writeScope;
+        if (!scope || scope.column !== first.writeScope.column || scopes.has(scope.value))
+            return false;
+        if (!writer.columns || signature(writer.columns) !== firstSignature)
+            return false;
+        scopes.add(scope.value);
+    }
+    return true;
+}
+/** Check physical ownership across local and already deployed stages. */
+export function validateWriteOwnership(stages, options) {
+    const findings = [];
+    const localAssets = collectAssets(stages, [], options?.catalog, options?.deployTarget, options?.postgresSnapshotBindings);
+    const localPhysical = new Set([...localAssets.values()].map((asset) => asset.physical));
+    collectAssets([...stages, ...(options?.externalStages ?? [])], findings, options?.catalog, options?.deployTarget, options?.postgresSnapshotBindings);
+    return findings.filter((finding) => finding.asset !== undefined && localPhysical.has(finding.asset));
+}
+/** Reference resolution (with near-miss suggestions) + column-subset checks. */
+function checkReferences(spec, index, findings) {
+    if (spec.type === 'transformation' &&
+        spec.inputs.length === 0 &&
+        spec.config?.raw_passthrough !== true) {
+        // Legal only as a scaffold state — a transformation with no declared
+        // inputs has no lineage edges.
+        findings.push({
+            code: 'no_inputs_declared',
+            severity: 'warning',
+            stage: spec.stage,
+            message: `'${spec.stage}' declares no inputs — wire its real inputs so the Pipeline DAG has lineage edges`,
+        });
+    }
+    for (const reference of consumedReferences(spec)) {
+        const inRepo = index.assetsById.get(reference.id);
+        const externalAsset = inRepo ? undefined : index.external[reference.id];
+        if (!inRepo && !externalAsset) {
+            const candidates = [...index.assetsById.keys(), ...Object.keys(index.external)];
+            const suggestions = nearMisses(reference.id, candidates);
+            findings.push({
+                code: 'unresolved_reference',
+                severity: 'error',
+                stage: spec.stage,
+                asset: reference.id,
+                suggestions,
+                message: `'${spec.stage}' (${reference.path}) references '${reference.id}', which no stage in this Pipeline or the asset export declares` +
+                    (suggestions.length > 0 ? ` — did you mean: ${suggestions.join(', ')}?` : ''),
+            });
+            continue;
+        }
+        const producerColumns = inRepo?.columns ?? externalAsset?.columns;
+        if (!reference.columns || reference.loose || !producerColumns)
+            continue;
+        for (const column of reference.columns) {
+            if (!(column in producerColumns)) {
+                findings.push({
+                    code: 'column_not_produced',
+                    severity: 'error',
+                    stage: spec.stage,
+                    asset: reference.id,
+                    consumers: [spec.stage],
+                    message: `'${spec.stage}' (${reference.path}) requires column '${column}' from '${reference.id}', which does not produce it`,
+                });
+            }
+        }
+    }
+}
+function transformationPublishIsParallel({ spec, deployCatalog, deployTarget, }) {
+    const catalog = resolveCatalogBinding({
+        binding: spec.config?.catalog,
+        deployTarget,
+    });
+    if (!catalog)
+        return { parallel: false };
+    if (typeof deployCatalog === 'string' &&
+        deployCatalog.length > 0 &&
+        catalog === deployCatalog) {
+        return { parallel: false, catalog };
+    }
+    return { parallel: true, catalog };
+}
+/**
+ * When a transformation producer writes a parallel UC namespace via
+ * `config.catalog`, serving must declare the same catalog. `resolveSpec` is
+ * per-spec and cannot see the producer, so omitting `source.catalog` would
+ * silently SNAPSHOT-sync the deploy-catalog copy (live JH gold on banksouth).
+ * Restating `config.catalog` as the deploy catalog is not parallel — serving
+ * should omit `source.catalog` (or restate the same deploy catalog).
+ */
+function checkServingProducerCatalog(spec, producerSpec, sourceId, findings, options) {
+    const publish = transformationPublishIsParallel({
+        spec: producerSpec,
+        deployCatalog: options?.catalog,
+        deployTarget: options?.deployTarget,
+    });
+    const sourceCatalog = resolveCatalogBinding({
+        binding: spec.source.catalog,
+        deployTarget: options?.deployTarget,
+    });
+    if (!publish.parallel) {
+        // Graph compatibility is checked against this in-repo producer. An
+        // explicit catalog override would sync a same-named table from another
+        // UC catalog whose contract was never validated.
+        if (sourceCatalog !== undefined && sourceCatalog !== options?.catalog) {
+            findings.push({
+                code: 'serving_source_catalog_mismatch',
+                severity: 'error',
+                stage: spec.stage,
+                asset: sourceId,
+                message: `'${spec.stage}' source.catalog ('${sourceCatalog}') is only valid when ` +
+                    `producer '${producerSpec.stage}' declares config.catalog (a parallel UC namespace). ` +
+                    `This producer writes the deploy catalog — omit source.catalog.`,
+            });
+        }
+        return;
+    }
+    if (sourceCatalog === publish.catalog)
+        return;
+    findings.push({
+        code: 'serving_source_catalog_mismatch',
+        severity: 'error',
+        stage: spec.stage,
+        asset: sourceId,
+        message: `'${spec.stage}' source.catalog must equal producer '${producerSpec.stage}' ` +
+            `config.catalog ('${publish.catalog}') — omitting it would sync the deploy-catalog ` +
+            `copy of '${spec.source.output}'. Got ${sourceCatalog === undefined ? 'unset' : `'${sourceCatalog}'`}.`,
+    });
+}
+/** `source.catalog` is only verifiable against an in-repo transformation producer. */
+function checkServingExternalCatalog(spec, sourceId, findings, deployTarget) {
+    const sourceCatalog = resolveCatalogBinding({
+        binding: spec.source.catalog,
+        deployTarget,
+    });
+    if (sourceCatalog === undefined)
+        return;
+    // Reviewed private snapshots retain their source copies independently of
+    // the producer. Complete source contracts still apply; Atlas separately
+    // requires the deployment-owned destination and exact stage fingerprint.
+    const namespace = spec.orm_binding?.namespace;
+    const targetAllowed = namespace === 'banksouth_relationships'
+        ? deployTarget === undefined || ['staging', 'dev'].includes(deployTarget)
+        : namespace === 'banksouth_fis' && (deployTarget === undefined || deployTarget === 'staging');
+    if (spec.source.external && spec.source.columns && spec.expose.public_view_access === 'orm_only' &&
+        /^dev_[a-z][a-z0-9_]*$/.test(sourceCatalog) && targetAllowed)
+        return;
+    findings.push({
+        code: 'serving_source_catalog_mismatch',
+        severity: 'error',
+        stage: spec.stage,
+        asset: sourceId,
+        message: `'${spec.stage}' source.catalog ('${sourceCatalog}') requires an in-repo ` +
+            `transformation producer that declares config.catalog — external asset ` +
+            `'${sourceId}' cannot be verified. Omit source.catalog.`,
+    });
+}
+/**
+ * Serving-specific offline checks: projection ⊆ source output (with type /
+ * nullability / domain compatibility), write-pattern × sync_mode sanity, and
+ * optional ORM `satisfies` contract enforcement.
+ */
+function checkServing(spec, stagesById, index, findings, options) {
+    const sourceId = `${spec.source.stage}.${spec.source.output}`;
+    const producer = (spec.source.external ? spec.source.columns : undefined) ??
+        index.assetsById.get(sourceId)?.columns ??
+        index.external[sourceId]?.columns;
+    const projection = softColumns(spec.projection.columns);
+    checkSnapshotSourceShape({ spec, producer, sourceId, findings });
+    // An unresolved projection ref was already reported as unresolved_schema_ref.
+    if (producer && projection) {
+        for (const finding of checkServingProjectionCompatibility({ producer, projection })) {
+            findings.push({
+                code: finding.code === 'missing_column' ? 'projection_column_missing' : 'projection_incompatible',
+                severity: finding.severity,
+                stage: spec.stage,
+                asset: sourceId,
+                consumers: [spec.stage],
+                message: `'${spec.stage}' projection: ${finding.message}`,
+            });
+        }
+    }
+    const producerSpec = stagesById.get(spec.source.stage);
+    if (producerSpec?.type === 'transformation') {
+        const output = producerSpec.outputs[spec.source.output];
+        checkServingProducerCatalog(spec, producerSpec, sourceId, findings, options);
+        // An overwrite (full-recompute, materialized-view-style) source only
+        // supports SNAPSHOT sync; TRIGGERED/CONTINUOUS need a CDF-capable
+        // relation. Full CDF capability is a plan-time (live catalog) check.
+        if (output && output.write_pattern === 'overwrite' && spec.sync_mode !== 'SNAPSHOT') {
+            findings.push({
+                code: 'sync_mode_incompatible',
+                severity: 'error',
+                stage: spec.stage,
+                asset: sourceId,
+                message: `'${spec.stage}' declares sync_mode ${spec.sync_mode} over '${sourceId}', which is written with write_pattern 'overwrite' — overwrite sources support SNAPSHOT only`,
+            });
+        }
+    }
+    else {
+        checkServingExternalCatalog(spec, sourceId, findings, options?.deployTarget);
+    }
+    checkServingSatisfies(spec, projection, findings, options?.ormContracts);
+}
+function checkServingSatisfies(spec, projection, findings, ormContracts) {
+    if (!spec.satisfies)
+        return;
+    if (ormContracts === undefined) {
+        findings.push({
+            code: 'orm_contract_unavailable',
+            severity: 'error',
+            stage: spec.stage,
+            consumers: [spec.stage],
+            message: `'${spec.stage}' declares satisfies but no ORM contract catalog was supplied — ` +
+                `commit orm-contracts.json beside the stage specs or run ` +
+                `\`seq-studio pipeline validate --orm-contracts <path>\` (fail closed; drift checks must not be skipped)`,
+        });
+        return;
+    }
+    if (!projection)
+        return;
+    const key = ormContractCatalogKey(spec.satisfies);
+    const contractFindings = checkServingSatisfiesOrmContract({
+        projection: { columns: projection, primary_key: spec.projection.primary_key },
+        satisfies: spec.satisfies,
+        contract: ormContracts[key],
+    });
+    for (const finding of contractFindings) {
+        const code = finding.code === 'orm_contract_unavailable' ||
+            finding.code === 'orm_contract_hash_mismatch' ||
+            finding.code === 'orm_contract_pk_mismatch'
+            ? finding.code
+            : 'orm_contract_incompatible';
+        findings.push({
+            code,
+            severity: finding.severity,
+            stage: spec.stage,
+            consumers: [spec.stage],
+            message: `'${spec.stage}' satisfies: ${finding.message}`,
+        });
+    }
+}
+/**
+ * Validate a Pipeline's stage graph offline. `externalAssets` (a registry
+ * export) resolves cross-Pipeline references; without it, every reference
+ * must resolve in-repo. Zero I/O.
+ *
+ * Pass `options.ormContracts` to enforce serving `satisfies:` against active
+ * ORM synced-table contracts (SEQ-2499).
+ */
+export function validateSpecGraph(definitions, externalAssets, options) {
+    const findings = [];
+    // Duplicate stage ids (parseSpecSources also rejects these; direct callers get the same guarantee).
+    const stagesById = new Map();
+    for (const spec of definitions) {
+        if (stagesById.has(spec.stage)) {
+            findings.push({
+                code: 'duplicate_stage_id',
+                severity: 'error',
+                stage: spec.stage,
+                message: `duplicate stage id '${spec.stage}'`,
+            });
+            continue;
+        }
+        stagesById.set(spec.stage, spec);
+    }
+    const stages = [...stagesById.values()];
+    const index = {
+        assetsById: collectAssets(stages, findings, options?.catalog, options?.deployTarget, options?.postgresSnapshotBindings),
+        external: externalAssets?.assets ?? {},
+    };
+    // Stage ids known to the graph: in-repo, plus stages the asset export
+    // implies (`<stage>.<asset>` keys) so cross-Pipeline trigger targets resolve.
+    const stageIds = new Set(stagesById.keys());
+    const externalStages = new Set(Object.keys(index.external)
+        .map((key) => key.split('.')[0])
+        .filter((stage) => stage !== undefined && stage.length > 0));
+    for (const spec of stages) {
+        for (const { path, ref } of unresolvedSchemaRefs(spec)) {
+            findings.push({
+                code: 'unresolved_schema_ref',
+                severity: 'error',
+                stage: spec.stage,
+                message: `'${spec.stage}' (${path}) holds an unresolved schema_ref '${ref}' — load specs through parseSpecSources/loadSpecDirectory (column checks for this position were skipped)`,
+            });
+        }
+        checkReferences(spec, index, findings);
+        checkTriggerTargets(spec, stageIds, externalStages, findings);
+        if (spec.type === 'transformation') {
+            for (const target of spec.trigger.refresh_serving ?? []) {
+                if (stageIds.has(target) || externalStages.has(target))
+                    continue;
+                findings.push({
+                    code: 'unresolved_trigger_target', severity: 'error', stage: spec.stage,
+                    message: `'${spec.stage}' trigger.refresh_serving target '${target}' is not declared or exported`,
+                });
+            }
+        }
+        if (spec.type === 'serving') {
+            checkServing(spec, stagesById, index, findings, options);
+        }
+    }
+    // Acyclicity across input edges and trigger.after edges.
+    const cycle = findCycle(stages);
+    if (cycle) {
+        findings.push({
+            code: 'cycle_detected',
+            severity: 'error',
+            cycle_path: cycle,
+            message: `stage graph has a cycle: ${cycle.join(' → ')}`,
+        });
+    }
+    return { ok: findings.every((finding) => finding.severity !== 'error'), findings };
+}
+function checkSnapshotSourceShape({ spec, producer, sourceId, findings }) {
+    if (spec.transport?.kind === 'postgres_snapshot_landing_v1' && (!producer ||
+        !fullSourceShapeEqual({ actual: producer, expected: spec.transport.full_source_columns }))) {
+        findings.push({ code: 'snapshot_source_shape_mismatch', severity: 'error', stage: spec.stage, asset: sourceId,
+            message: `'${spec.stage}' snapshot transport requires the exact complete producer column/type/nullability shape; a projection subset is not full raw fidelity`,
+        });
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/hash.d.ts

@@ -0,0 +1,28 @@
+import type { StageSpec } from './envelope.js';
+/**
+ * Key-sorted, undefined-skipped JSON — identical specs serialize identically
+ * regardless of YAML key order, so hashes are stable across processes and
+ * authoring styles. The same canonical form is used for resolved snapshots.
+ */
+export declare function canonicalJson(value: unknown): string;
+/** Hash of the full canonical portable spec — changes on ANY edit. */
+export declare function computeSpecHash(spec: StageSpec): string;
+/**
+ * The contract-bearing surface of a spec: what downstream consumers depend
+ * on. Cosmetic edits do NOT appear here, so they never churn `contract_hash`
+ * — that includes top-level fields (title, runbook, owners, alerts) AND the
+ * NESTED `description` keys on feeds, outputs, columns, and projection
+ * columns, plus ingestion `columns` and `column_descriptions`. Everything else in these
+ * objects is contract-bearing:
+ *
+ * - ingestion  → source identity + feeds (batch semantics, keys, cursors,
+ *   formats, pii). The source identity (`source.system` / `worker.data_source`)
+ *   determines every derived bronze name, so renaming it IS a contract change;
+ *   the CREDENTIAL is a deployment binding, deliberately NOT contract surface.
+ * - transformation → outputs (columns + write/violation/compat posture)
+ * - serving   → source, projection, sync_mode, exposed view, orm_binding, satisfies
+ */
+export declare function contractSurface(spec: StageSpec): Record<string, unknown>;
+/** Hash of just the contract-bearing surface — stable across cosmetic edits. */
+export declare function computeContractHash(spec: StageSpec): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQpD;AAKD,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEvD;AAgBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsCxE;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE3D"}