@sequenceholdings/pipeline-spec 0.1.0

package/dist/hash.js

@@ -0,0 +1,91 @@
+import { createHash } from 'node:crypto';
+import { CONTRACT_HASH_DOMAIN, SPEC_HASH_DOMAIN } from './constants.js';
+import { isSchemaRef } from './columns.js';
+import { feedContract, ingestionSourceIdentity } from './bodies/ingestion.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 function canonicalJson(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(',')}]`;
+    const entries = Object.entries(value)
+        .filter(([, entryValue]) => entryValue !== undefined)
+        .sort(([a], [b]) => (a < b ? -1 : 1))
+        .map(([key, entryValue]) => `${JSON.stringify(key)}:${canonicalJson(entryValue)}`);
+    return `{${entries.join(',')}}`;
+}
+const sha256 = (domain, payload) => createHash('sha256').update(domain).update(payload).digest('hex');
+/** Hash of the full canonical portable spec — changes on ANY edit. */
+export function computeSpecHash(spec) {
+    return sha256(SPEC_HASH_DOMAIN, canonicalJson(spec));
+}
+/** Drop the one cosmetic key nested contract objects carry. Everything else is contract-bearing. */
+function omitDescription(value) {
+    const { description: _description, ...contract } = value;
+    return contract;
+}
+/** Columns with per-column `description` stripped; refs pass through (the ref name is the contract). */
+function contractColumns(columns) {
+    if (isSchemaRef(columns))
+        return columns;
+    return Object.fromEntries(Object.entries(columns).map(([name, column]) => [name, omitDescription(column)]));
+}
+/**
+ * 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 function contractSurface(spec) {
+    switch (spec.type) {
+        case 'ingestion':
+            return {
+                type: spec.type,
+                stage: spec.stage,
+                source: ingestionSourceIdentity(spec),
+                feeds: Object.fromEntries(Object.entries(spec.feeds).map(([name, feed]) => [name, feedContract(feed)])),
+            };
+        case 'transformation':
+            return {
+                type: spec.type,
+                stage: spec.stage,
+                outputs: Object.fromEntries(Object.entries(spec.outputs).map(([asset, output]) => [
+                    asset,
+                    { ...omitDescription(output), columns: contractColumns(output.columns) },
+                ])),
+            };
+        case 'serving':
+            return {
+                type: spec.type,
+                stage: spec.stage,
+                source: spec.source,
+                projection: {
+                    columns: contractColumns(spec.projection.columns),
+                    primary_key: spec.projection.primary_key,
+                },
+                ...(spec.transport ? { transport: spec.transport } : {}),
+                sync_mode: spec.sync_mode,
+                expose: spec.expose,
+                orm_binding: spec.orm_binding,
+                satisfies: spec.satisfies,
+            };
+    }
+}
+/** Hash of just the contract-bearing surface — stable across cosmetic edits. */
+export function computeContractHash(spec) {
+    return sha256(CONTRACT_HASH_DOMAIN, canonicalJson(contractSurface(spec)));
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { COLUMN_IDENTIFIER_PATTERN, CONTRACT_HASH_DOMAIN, DEPLOY_TARGET_PATTERN, DOCUMENTATION_DIRECTORY, DOCUMENTATION_FILE_SUFFIXES, GOLD_ASSET_PATTERN, IDENTIFIER_PATTERN, MAX_SPEC_FILE_BYTES, MAX_STAGE_SPEC_FILE_BYTES, OUTPUT_ASSET_PATTERN, PUBLIC_VIEW_PATTERN, REPORT_ASSET_PATTERN, REPORTING_TABLE_PATTERN, QUARANTINE_SUFFIX, RESERVED_OPERATION_NAMES, SCHEMA_FILE_SUFFIXES, SCHEMAS_DIRECTORY, SPEC_HASH_DOMAIN, STAGE_FILE_SUFFIXES, STAGE_ID_PATTERN, SYMBOLIC_REF_PATTERN, quarantineAssetName, } from './constants.js';
+export { RESOLUTION_ERROR_CODES, SpecDefinitionError, SpecResolutionError, type ResolutionErrorCode, } from './errors.js';
+export { credentialLikeReason, scanForCredentialLikeStrings, type CredentialFinding, } from './secret-scan.js';
+export { DECIMAL_TYPE_PATTERN, DELTA_ONLY_TYPES, ORM_COLUMN_TYPES, ORM_MAPPABLE_TYPES, PIPELINE_TO_ORM_TYPE, ormMappable, ormMappingSuggestion, pipelineTypeSchema, pipelineToOrmType, type DeltaOnlyType, type OrmColumnType, type OrmMappableType, type PipelineType, } from './types.js';
+export { columnIdentifierSchema, columnMapSchema, columnSchema, columnsOrRefSchema, identifierSchema, isSchemaRef, namedSchemaFileSchema, nullableKeyColumns, requireResolvedColumns, schemaRefSchema, type Column, type ColumnInput, type ColumnMap, type ColumnsOrRef, type NamedSchemaFile, type SchemaRef, } from './columns.js';
+export { catalogBindingSchema, resolveCatalogBinding, targetAwareCatalogSchema, type CatalogBinding, } from './catalog-binding.js';
+export { OPERATION_SCALAR_TYPES, operationInvocationSchema, operationNameSchema, operationParamSchema, operationPolicySchema, operationSchema, operationsBlockSchema, validateOperationParams, type OperationInvocation, type OperationParam, type OperationPolicy, type OperationScalarType, type OperationSpec, type OperationsBlock, type ParamValidationResult, } from './operations.js';
+export { DEFAULT_MATERIALIZER_CONCURRENT, FEED_FORMATS, INGESTION_RUNTIMES, MATERIALIZER_STRATEGIES, MAX_MATERIALIZER_CONCURRENT, MAX_WORKER_CONCURRENT, SNAPSHOT_MODES, cursorSchema, feedBronzeTable, feedNameSchema, feedSchema, feedVolumePath, ingestionRuntimeSchema, ingestionSourceIdentity, materializerConcurrencySchema, materializerStrategySchema, sourceCatalog, isoDurationSchema, repoRelativePathSchema, scheduleSchema, snapshotModeSchema, sourceSystemSchema, symbolicRefSchema, workerCapacityGroup, workerSchema, type FeedFormat, type FeedSpec, type IngestionRuntime, type MaterializerStrategy, type ScheduleSpec, type SnapshotMode, } from './bodies/ingestion.js';
+export { LAKEBASE_CDF_ENVELOPE_COLUMNS, TRANSFORMATION_ENGINES, WRITE_PATTERNS, isLakebaseCdfInput, outputAssetNameSchema, transformationEngineSchema, transformationInputSchema, transformationOutputSchema, transformationTriggerSchema, writePatternSchema, writeScopeSchema, type LakebaseCdfInput, type StageInput, type TransformationEngine, type TransformationInput, type TransformationOutput, type TransformationTrigger, type WritePattern, } from './bodies/transformation.js';
+export { PUBLIC_VIEW_ACCESS, SYNC_MODES, ormBindingSchema, publicViewAccessSchema, projectionSchema, satisfiesSchema, syncModeSchema, type OrmBinding, type PublicViewAccess, type Projection, type SatisfiesBinding, type SyncMode, } from './bodies/serving.js';
+export { CRITICALITIES, REMEDIATION_POSTURES, alertsSchema, criticalitySchema, deployTargetSchema, ingestionStageSchema, remediationPostureSchema, servingStageSchema, slosSchema, stageIdSchema, stageSpecSchema, transformationStageSchema, type Alerts, type Criticality, type IngestionStageSpec, type RemediationPosture, type ServingStageSpec, type Slos, type StageSpec, type StageSpecInput, type TransformationStageSpec, } from './envelope.js';
+export { flattenSpecIssues, formatSpecIssues, type SpecIssue } from './issues.js';
+export { loadSpecDirectory, parseSpecSources, parseStageFile, type LoadedPipeline, type SpecSource, } from './loader.js';
+export { canonicalJson, computeContractHash, computeSpecHash, contractSurface } from './hash.js';
+export { collectBindingGaps, collectPipelineBindingGaps, type BindingGap, } from './binding-gaps.js';
+export { resolveSpec, targetFactsSchema, transformationOutputCatalog, type ResolvedBindings, type ResolvedIdentity, type ResolvedNames, type ResolvedProvenance, type ResolvedSpec, type SpecProvenanceInput, type TargetFacts, type TargetFactsInput, } from './resolve.js';
+export { COMPATIBILITY_FINDING_CODES, checkCompatibility, type CompatibilityFinding, type CompatibilityFindingCode, } from './compatibility.js';
+export { ORM_SATISFIES_FINDING_CODES, checkServingSatisfiesOrmContract, ormContractCatalogKey, ormContractCatalogSchema, ormSyncedContractRequirementSchema, type OrmContractCatalog, type OrmSatisfiesFinding, type OrmSatisfiesFindingCode, type OrmSyncedContractRequirement, } from './orm-satisfies.js';
+export { CONTRACT_CHANGE_CODES, diffContracts, type ContractChange, type ContractChangeCode, type ContractClassification, type ContractDiff, type OutputContractDiff, } from './diff.js';
+export { GRAPH_FINDING_CODES, externalAssetsExportSchema, validateSpecGraph, validateWriteOwnership, type ExternalAssetsExport, type GraphFinding, type GraphFindingCode, type GraphValidationResult, type ValidateSpecGraphOptions, } from './graph.js';
+export { buildPerTableIngestionStages, generatePerTableStageFiles, perTableStageSlug, tableToSlug, type GeneratedStageFile, type IngestionTableDefinition, type PerTableIngestionAuthoring, } from './authoring/per-table-ingestion.js';
+export { dumpStageYaml } from './authoring/yaml.js';
+export { MIGRATIONS_DIRECTORY, MIGRATION_FILE_PATTERN, migrationManifestSchema, migrationExecutionModeSchema, migrationCheckSchema, parseMigrationFile, computeMigrationChecksum, validateMigrationHistory, type MigrationManifest, type MigrationExecutionMode, type MigrationCheck, type MigrationFinding, } from './migrations/manifest.js';
+export { analyzeMigrationContracts, type MigrationParticipantContracts, type MigrationColumnChange, type MigrationContractReport, } from './migrations/contracts.js';
+export * from './snapshot-transport.js';
+export { consumedReferences, triggerTargets } from './graph-references.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,27 @@
+export { COLUMN_IDENTIFIER_PATTERN, CONTRACT_HASH_DOMAIN, DEPLOY_TARGET_PATTERN, DOCUMENTATION_DIRECTORY, DOCUMENTATION_FILE_SUFFIXES, GOLD_ASSET_PATTERN, IDENTIFIER_PATTERN, MAX_SPEC_FILE_BYTES, MAX_STAGE_SPEC_FILE_BYTES, OUTPUT_ASSET_PATTERN, PUBLIC_VIEW_PATTERN, REPORT_ASSET_PATTERN, REPORTING_TABLE_PATTERN, QUARANTINE_SUFFIX, RESERVED_OPERATION_NAMES, SCHEMA_FILE_SUFFIXES, SCHEMAS_DIRECTORY, SPEC_HASH_DOMAIN, STAGE_FILE_SUFFIXES, STAGE_ID_PATTERN, SYMBOLIC_REF_PATTERN, quarantineAssetName, } from './constants.js';
+export { RESOLUTION_ERROR_CODES, SpecDefinitionError, SpecResolutionError, } from './errors.js';
+export { credentialLikeReason, scanForCredentialLikeStrings, } from './secret-scan.js';
+export { DECIMAL_TYPE_PATTERN, DELTA_ONLY_TYPES, ORM_COLUMN_TYPES, ORM_MAPPABLE_TYPES, PIPELINE_TO_ORM_TYPE, ormMappable, ormMappingSuggestion, pipelineTypeSchema, pipelineToOrmType, } from './types.js';
+export { columnIdentifierSchema, columnMapSchema, columnSchema, columnsOrRefSchema, identifierSchema, isSchemaRef, namedSchemaFileSchema, nullableKeyColumns, requireResolvedColumns, schemaRefSchema, } from './columns.js';
+export { catalogBindingSchema, resolveCatalogBinding, targetAwareCatalogSchema, } from './catalog-binding.js';
+export { OPERATION_SCALAR_TYPES, operationInvocationSchema, operationNameSchema, operationParamSchema, operationPolicySchema, operationSchema, operationsBlockSchema, validateOperationParams, } from './operations.js';
+export { DEFAULT_MATERIALIZER_CONCURRENT, FEED_FORMATS, INGESTION_RUNTIMES, MATERIALIZER_STRATEGIES, MAX_MATERIALIZER_CONCURRENT, MAX_WORKER_CONCURRENT, SNAPSHOT_MODES, cursorSchema, feedBronzeTable, feedNameSchema, feedSchema, feedVolumePath, ingestionRuntimeSchema, ingestionSourceIdentity, materializerConcurrencySchema, materializerStrategySchema, sourceCatalog, isoDurationSchema, repoRelativePathSchema, scheduleSchema, snapshotModeSchema, sourceSystemSchema, symbolicRefSchema, workerCapacityGroup, workerSchema, } from './bodies/ingestion.js';
+export { LAKEBASE_CDF_ENVELOPE_COLUMNS, TRANSFORMATION_ENGINES, WRITE_PATTERNS, isLakebaseCdfInput, outputAssetNameSchema, transformationEngineSchema, transformationInputSchema, transformationOutputSchema, transformationTriggerSchema, writePatternSchema, writeScopeSchema, } from './bodies/transformation.js';
+export { PUBLIC_VIEW_ACCESS, SYNC_MODES, ormBindingSchema, publicViewAccessSchema, projectionSchema, satisfiesSchema, syncModeSchema, } from './bodies/serving.js';
+export { CRITICALITIES, REMEDIATION_POSTURES, alertsSchema, criticalitySchema, deployTargetSchema, ingestionStageSchema, remediationPostureSchema, servingStageSchema, slosSchema, stageIdSchema, stageSpecSchema, transformationStageSchema, } from './envelope.js';
+export { flattenSpecIssues, formatSpecIssues } from './issues.js';
+export { loadSpecDirectory, parseSpecSources, parseStageFile, } from './loader.js';
+export { canonicalJson, computeContractHash, computeSpecHash, contractSurface } from './hash.js';
+export { collectBindingGaps, collectPipelineBindingGaps, } from './binding-gaps.js';
+export { resolveSpec, targetFactsSchema, transformationOutputCatalog, } from './resolve.js';
+export { COMPATIBILITY_FINDING_CODES, checkCompatibility, } from './compatibility.js';
+export { ORM_SATISFIES_FINDING_CODES, checkServingSatisfiesOrmContract, ormContractCatalogKey, ormContractCatalogSchema, ormSyncedContractRequirementSchema, } from './orm-satisfies.js';
+export { CONTRACT_CHANGE_CODES, diffContracts, } from './diff.js';
+export { GRAPH_FINDING_CODES, externalAssetsExportSchema, validateSpecGraph, validateWriteOwnership, } from './graph.js';
+export { buildPerTableIngestionStages, generatePerTableStageFiles, perTableStageSlug, tableToSlug, } from './authoring/per-table-ingestion.js';
+export { dumpStageYaml } from './authoring/yaml.js';
+export { MIGRATIONS_DIRECTORY, MIGRATION_FILE_PATTERN, migrationManifestSchema, migrationExecutionModeSchema, migrationCheckSchema, parseMigrationFile, computeMigrationChecksum, validateMigrationHistory, } from './migrations/manifest.js';
+export { analyzeMigrationContracts, } from './migrations/contracts.js';
+export * from './snapshot-transport.js';
+export { consumedReferences, triggerTargets } from './graph-references.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/issues.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+/**
+ * Zod issue flattening shared by the loader, the CLI, and tests — so union
+ * failures (e.g. the transformation input union) surface the ACTIONABLE
+ * nested issues ("fold is required") instead of a generic "Invalid input".
+ */
+export interface SpecIssue {
+    /** Dotted path within the spec document. */
+    readonly path: string;
+    readonly message: string;
+}
+export declare function flattenSpecIssues(error: z.ZodError): SpecIssue[];
+export declare function formatSpecIssues(error: z.ZodError): string;
+//# sourceMappingURL=issues.d.ts.map

package/dist/issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../src/issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;GAIG;AAEH,MAAM,WAAW,SAAS;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AA0BD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,SAAS,EAAE,CAEhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAI1D"}

package/dist/issues.js

@@ -0,0 +1,27 @@
+function flattenIssue(issue, prefix) {
+    const path = [...prefix, ...issue.path];
+    if (issue.code === 'invalid_union' && issue.errors.length > 0) {
+        // Pick the union option that got CLOSEST to matching (fewest issues) —
+        // for a `kind: lakebase_cdf` input missing `fold`, that is the CDF
+        // option's "fold required", not the stage option's pile of mismatches.
+        const flattenedOptions = issue.errors.map((optionIssues) => optionIssues.flatMap((optionIssue) => flattenIssue(optionIssue, path)));
+        const closest = flattenedOptions.reduce((best, current) => current.length < best.length ? current : best);
+        if (closest.length > 0)
+            return closest;
+    }
+    return [
+        {
+            path: path.map(String).join('.'),
+            message: issue.message,
+        },
+    ];
+}
+export function flattenSpecIssues(error) {
+    return error.issues.flatMap((issue) => flattenIssue(issue, []));
+}
+export function formatSpecIssues(error) {
+    return flattenSpecIssues(error)
+        .map((issue) => (issue.path.length > 0 ? `${issue.path}: ${issue.message}` : issue.message))
+        .join('; ');
+}
+//# sourceMappingURL=issues.js.map

package/dist/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../src/issues.ts"],"names":[],"mappings":"AAgBA,SAAS,YAAY,CAAC,KAAmB,EAAE,MAA8B;IACvE,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IACvC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,uEAAuE;QACvE,mEAAmE;QACnE,uEAAuE;QACvE,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CACzD,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CACvE,CAAA;QACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CACxD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAC9C,CAAA;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,OAAO,CAAA;IACxC,CAAC;IACD,OAAO;QACL;YACE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAiB;IACjD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAA;AACjE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,OAAO,iBAAiB,CAAC,KAAK,CAAC;SAC5B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;SAC3F,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,50 @@
+import { type ColumnMap } from './columns.js';
+import { type StageSpec } from './envelope.js';
+import { type MigrationManifest } from './migrations/manifest.js';
+/**
+ * A directory = one Pipeline's stage definitions:
+ *
+ * ```
+ * pipelines/<domain>/
+ * ├── <stage>.stage.yml          # stage specs (this loader)
+ * ├── schemas/<name>.schema.yml  # named schema artifacts (schema_ref targets)
+ * ├── documentation/<name>.documentation.yml # feed documentation_ref targets
+ * └── src/…                      # entrypoints / decoders (not parsed here)
+ * ```
+ *
+ * `parseSpecSources` is the ONE parse path (raw sources → validated
+ * definitions) shared by the CLI, CI gate, and the future registry — a local
+ * directory and an uploaded bundle can't diverge. `loadSpecDirectory` is the
+ * filesystem shell around it.
+ *
+ * After loading, every `schema_ref` is resolved: consumers of the same named
+ * schema share the same validated column-map instance (identity, not copies).
+ */
+export interface SpecSource {
+    /** Path relative to the Pipeline root (e.g. `players.stage.yml`, `schemas/player.schema.yml`). */
+    readonly path: string;
+    readonly contents: string;
+}
+export interface LoadedPipeline {
+    readonly stages: readonly StageSpec[];
+    /** Resolved named schemas, keyed by artifact name. */
+    readonly schemas: Readonly<Record<string, ColumnMap>>;
+    readonly files: readonly string[];
+    readonly migrations?: readonly MigrationManifest[];
+}
+/** Parse and validate a single stage spec source (no ref resolution). */
+export declare function parseStageFile(file: string, contents: string): StageSpec;
+/**
+ * Raw sources → validated Pipeline definition: the one parse path. Splits
+ * named schema artifacts (`schemas/*.schema.yml`) from stage specs
+ * (`*.stage.yml`), validates each, resolves `schema_ref`s (shared identity),
+ * and enforces Pipeline-level uniqueness (stage ids).
+ */
+export declare function parseSpecSources(sources: readonly SpecSource[]): LoadedPipeline;
+/**
+ * Load a Pipeline directory from disk: `*.stage.yml` at the root plus
+ * `schemas/*.schema.yml` and `documentation/*.documentation.yml`.
+ * The filesystem shell around `parseSpecSources`.
+ */
+export declare function loadSpecDirectory(dir: string): Promise<LoadedPipeline>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAeA,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,cAAc,CAAA;AACrB,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAE/D,OAAO,EAA6F,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAE5J;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,UAAU;IACzB,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAA;IACrC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;IACrD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACnD;AA2BD,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAcxE;AA0GD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,cAAc,CA6E/E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA8C5E"}

package/dist/loader.js

@@ -0,0 +1,241 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { load as loadYaml } from 'js-yaml';
+import { MAX_SPEC_FILE_BYTES, MAX_STAGE_SPEC_FILE_BYTES, DOCUMENTATION_DIRECTORY, DOCUMENTATION_FILE_SUFFIXES, SCHEMA_FILE_SUFFIXES, SCHEMAS_DIRECTORY, STAGE_FILE_SUFFIXES, } from './constants.js';
+import { SpecDefinitionError } from './errors.js';
+import { flattenSpecIssues, formatSpecIssues } from './issues.js';
+import { isSchemaRef, identifierSchema, namedSchemaFileSchema, } from './columns.js';
+import { stageSpecSchema } from './envelope.js';
+import { feedDocumentationSchema, resolveFeedDocumentation } from './documentation.js';
+import { MIGRATION_FILE_PATTERN, MIGRATIONS_DIRECTORY, orderMigrationManifests, parseMigrationFile } from './migrations/manifest.js';
+const hasSuffix = (name, suffixes) => suffixes.some((suffix) => name.endsWith(suffix));
+const stripSuffix = (name, suffixes) => {
+    for (const suffix of suffixes) {
+        if (name.endsWith(suffix))
+            return name.slice(0, -suffix.length);
+    }
+    return name;
+};
+const baseName = (path) => path.split('/').at(-1) ?? path;
+function parseYamlSource(file, contents) {
+    try {
+        return loadYaml(contents);
+    }
+    catch (error) {
+        throw new SpecDefinitionError(error instanceof Error ? error.message : 'invalid YAML', file);
+    }
+}
+function firstIssue(error) {
+    const issue = flattenSpecIssues(error)[0];
+    return issue ?? { path: '', message: 'invalid' };
+}
+/** Parse and validate a single stage spec source (no ref resolution). */
+export function parseStageFile(file, contents) {
+    const parsed = stageSpecSchema.safeParse(parseYamlSource(file, contents));
+    if (!parsed.success) {
+        throw new SpecDefinitionError(formatSpecIssues(parsed.error), file, firstIssue(parsed.error).path);
+    }
+    const expectedStage = stripSuffix(baseName(file), STAGE_FILE_SUFFIXES);
+    if (parsed.data.stage !== expectedStage) {
+        throw new SpecDefinitionError(`stage id '${parsed.data.stage}' must match the file basename '${expectedStage}'`, file, 'stage');
+    }
+    return parsed.data;
+}
+/**
+ * Resolve named schema artifacts, following ref chains (a schema may alias
+ * another) and rejecting cycles with the full chain in the error.
+ */
+function resolveNamedSchemas(raw) {
+    const resolved = {};
+    const resolving = [];
+    const resolve = (name) => {
+        const existing = resolved[name];
+        if (existing)
+            return existing;
+        const entry = raw.get(name);
+        if (!entry) {
+            const from = resolving.at(-1);
+            throw new SpecDefinitionError(`schema_ref '${name}' does not resolve — no ${SCHEMAS_DIRECTORY}/${name}.schema.yml in this Pipeline`, from ? raw.get(from)?.file : undefined);
+        }
+        if (resolving.includes(name)) {
+            throw new SpecDefinitionError(`schema_ref cycle: ${[...resolving.slice(resolving.indexOf(name)), name].join(' → ')}`, entry.file);
+        }
+        resolving.push(name);
+        const target = isSchemaRef(entry.columns) ? resolve(entry.columns.schema_ref) : { columns: entry.columns };
+        const schema = { columns: target.columns, description: entry.description ?? target.description };
+        resolving.pop();
+        resolved[name] = schema;
+        return schema;
+    };
+    for (const name of raw.keys())
+        resolve(name);
+    return resolved;
+}
+/**
+ * Replace every `schema_ref` position in a validated stage spec with the
+ * shared resolved column map. Mutates the parsed spec in place (it is ours,
+ * fresh from the schema) so two consumers of one ref share identity.
+ */
+function resolveSpecRefs(spec, file, schemas) {
+    const lookup = (ref, path) => {
+        const schema = schemas[ref];
+        if (!schema) {
+            throw new SpecDefinitionError(`schema_ref '${ref}' does not resolve — no ${SCHEMAS_DIRECTORY}/${ref}.schema.yml in this Pipeline`, file, path);
+        }
+        return schema;
+    };
+    if (spec.type === 'transformation') {
+        for (const [asset, output] of Object.entries(spec.outputs)) {
+            if (isSchemaRef(output.columns)) {
+                const schema = lookup(output.columns.schema_ref, `outputs.${asset}.columns`);
+                output.columns = schema.columns;
+                if (output.description === undefined && schema.description !== undefined) {
+                    output.description = schema.description;
+                }
+            }
+        }
+        spec.inputs.forEach((input, index) => {
+            if ('kind' in input && input.kind === 'lakebase_cdf' && isSchemaRef(input.columns)) {
+                input.columns = lookup(input.columns.schema_ref, `inputs.${index}.columns`).columns;
+            }
+        });
+    }
+    if (spec.type === 'serving' && isSchemaRef(spec.projection.columns)) {
+        spec.projection.columns = lookup(spec.projection.columns.schema_ref, 'projection.columns').columns;
+    }
+}
+/**
+ * Refinements that need resolved columns are skipped by the schema when the
+ * position is a `schema_ref`; re-run the spec through the schema after
+ * resolution so those checks always apply to loaded definitions, then restore
+ * shared-identity column maps (parsing clones).
+ */
+function revalidateResolved(spec, file) {
+    const reparsed = stageSpecSchema.safeParse(spec);
+    if (!reparsed.success) {
+        throw new SpecDefinitionError(formatSpecIssues(reparsed.error), file, firstIssue(reparsed.error).path);
+    }
+}
+/**
+ * Raw sources → validated Pipeline definition: the one parse path. Splits
+ * named schema artifacts (`schemas/*.schema.yml`) from stage specs
+ * (`*.stage.yml`), validates each, resolves `schema_ref`s (shared identity),
+ * and enforces Pipeline-level uniqueness (stage ids).
+ */
+export function parseSpecSources(sources) {
+    const rawSchemas = new Map();
+    const documentation = new Map();
+    const stageSources = [];
+    const migrations = new Map();
+    for (const source of sources) {
+        const maxBytes = hasSuffix(source.path, STAGE_FILE_SUFFIXES) ? MAX_STAGE_SPEC_FILE_BYTES : MAX_SPEC_FILE_BYTES;
+        if (Buffer.byteLength(source.contents, 'utf8') > maxBytes) {
+            throw new SpecDefinitionError(`exceeds the maximum spec file size of ${maxBytes} bytes`, source.path);
+        }
+        if (source.path.startsWith(`${DOCUMENTATION_DIRECTORY}/`)) {
+            const name = stripSuffix(baseName(source.path), DOCUMENTATION_FILE_SUFFIXES);
+            if (!hasSuffix(source.path, DOCUMENTATION_FILE_SUFFIXES) || source.path.split('/').length !== 2 || !identifierSchema.safeParse(name).success) {
+                throw new SpecDefinitionError('expected documentation/<identifier>.documentation.yml', source.path);
+            }
+            if (documentation.has(name))
+                throw new SpecDefinitionError(`duplicate documentation '${name}'`, source.path);
+            const parsed = feedDocumentationSchema.safeParse(parseYamlSource(source.path, source.contents));
+            if (!parsed.success)
+                throw new SpecDefinitionError(formatSpecIssues(parsed.error), source.path, firstIssue(parsed.error).path);
+            documentation.set(name, parsed.data);
+            continue;
+        }
+        if (source.path.startsWith(`${MIGRATIONS_DIRECTORY}/`)) {
+            const migration = parseMigrationFile(source.path, source.contents);
+            if (migrations.has(migration.id))
+                throw new SpecDefinitionError(`duplicate migration '${migration.id}'`, source.path);
+            migrations.set(migration.id, migration);
+            continue;
+        }
+        if (hasSuffix(source.path, SCHEMA_FILE_SUFFIXES)) {
+            const name = stripSuffix(baseName(source.path), SCHEMA_FILE_SUFFIXES);
+            if (rawSchemas.has(name)) {
+                throw new SpecDefinitionError(`duplicate schema artifact '${name}'`, source.path);
+            }
+            const parsed = namedSchemaFileSchema.safeParse(parseYamlSource(source.path, source.contents));
+            if (!parsed.success) {
+                throw new SpecDefinitionError(formatSpecIssues(parsed.error), source.path, firstIssue(parsed.error).path);
+            }
+            rawSchemas.set(name, { file: source.path, ...parsed.data });
+            continue;
+        }
+        if (hasSuffix(source.path, STAGE_FILE_SUFFIXES)) {
+            stageSources.push(source);
+            continue;
+        }
+        throw new SpecDefinitionError(`unrecognized spec file — expected *${STAGE_FILE_SUFFIXES[0]}, ${SCHEMAS_DIRECTORY}/*${SCHEMA_FILE_SUFFIXES[0]}, or ${DOCUMENTATION_DIRECTORY}/*${DOCUMENTATION_FILE_SUFFIXES[0]}`, source.path);
+    }
+    const schemas = resolveNamedSchemas(rawSchemas);
+    const stages = [];
+    const seen = new Map();
+    for (const source of stageSources) {
+        const spec = parseStageFile(source.path, source.contents);
+        const duplicate = seen.get(spec.stage);
+        if (duplicate) {
+            throw new SpecDefinitionError(`duplicate stage id '${spec.stage}' (also declared in ${duplicate})`, source.path, 'stage');
+        }
+        seen.set(spec.stage, source.path);
+        resolveFeedDocumentation({ spec, file: source.path, documentation });
+        resolveSpecRefs(spec, source.path, schemas);
+        revalidateResolved(spec, source.path);
+        stages.push(spec);
+    }
+    return {
+        stages,
+        schemas: Object.fromEntries(Object.entries(schemas).map(([name, schema]) => [name, schema.columns])),
+        files: sources.map((source) => source.path),
+        ...(migrations.size > 0 ? { migrations: orderMigrationManifests([...migrations.values()]) } : {}),
+    };
+}
+/**
+ * Load a Pipeline directory from disk: `*.stage.yml` at the root plus
+ * `schemas/*.schema.yml` and `documentation/*.documentation.yml`.
+ * The filesystem shell around `parseSpecSources`.
+ */
+export async function loadSpecDirectory(dir) {
+    const sources = [];
+    const rootEntries = await readdir(dir, { withFileTypes: true });
+    const stageFiles = rootEntries
+        .filter((entry) => entry.isFile() && hasSuffix(entry.name, STAGE_FILE_SUFFIXES))
+        .map((entry) => entry.name)
+        .sort();
+    const schemaDirEntries = rootEntries.some((entry) => entry.isDirectory() && entry.name === SCHEMAS_DIRECTORY)
+        ? await readdir(join(dir, SCHEMAS_DIRECTORY), { withFileTypes: true })
+        : [];
+    const schemaFiles = schemaDirEntries
+        .filter((entry) => entry.isFile() && hasSuffix(entry.name, SCHEMA_FILE_SUFFIXES))
+        .map((entry) => `${SCHEMAS_DIRECTORY}/${entry.name}`)
+        .sort();
+    const documentationDirEntries = rootEntries.some((entry) => entry.isDirectory() && entry.name === DOCUMENTATION_DIRECTORY)
+        ? await readdir(join(dir, DOCUMENTATION_DIRECTORY), { withFileTypes: true })
+        : [];
+    const documentationFiles = documentationDirEntries
+        .filter((entry) => entry.isFile() && hasSuffix(entry.name, DOCUMENTATION_FILE_SUFFIXES))
+        .map((entry) => `${DOCUMENTATION_DIRECTORY}/${entry.name}`)
+        .sort();
+    const migrationDirEntries = rootEntries.some((entry) => entry.isDirectory() && entry.name === MIGRATIONS_DIRECTORY)
+        ? await readdir(join(dir, MIGRATIONS_DIRECTORY), { withFileTypes: true })
+        : [];
+    const migrationFiles = migrationDirEntries
+        .filter((entry) => entry.isFile() && /\.ya?ml$/.test(entry.name))
+        .map((entry) => `${MIGRATIONS_DIRECTORY}/${entry.name}`)
+        .sort();
+    for (const file of migrationFiles) {
+        if (!MIGRATION_FILE_PATTERN.test(file))
+            throw new SpecDefinitionError('expected migrations/<id>.yml', file);
+    }
+    if (stageFiles.length === 0) {
+        throw new SpecDefinitionError(`no *${STAGE_FILE_SUFFIXES[0]} files in ${dir}`);
+    }
+    for (const file of [...schemaFiles, ...documentationFiles, ...stageFiles, ...migrationFiles]) {
+        const contents = await readFile(join(dir, file), 'utf8');
+        sources.push({ path: file, contents });
+    }
+    return parseSpecSources(sources);
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/migrations/contracts.d.ts

@@ -0,0 +1,38 @@
+import type { StageSpec } from '../envelope.js';
+import type { MigrationFinding, MigrationManifest } from './manifest.js';
+export interface MigrationParticipantContracts {
+    readonly repo: string;
+    readonly before: readonly StageSpec[];
+    readonly after: readonly StageSpec[];
+}
+export interface MigrationColumnChange {
+    readonly repo: string;
+    readonly stage: string;
+    readonly output: string;
+    readonly physicalTable: string;
+    readonly column: string;
+    readonly kind: 'add_column' | 'change_column_type';
+    readonly oldType: string | null;
+    readonly newType: string;
+}
+export interface MigrationContractReport {
+    readonly changes: readonly MigrationColumnChange[];
+    readonly findings: readonly MigrationFinding[];
+}
+type AnalysisInput = {
+    readonly rootRepo: string;
+    readonly manifest?: MigrationManifest;
+    readonly participants: readonly MigrationParticipantContracts[];
+    readonly externalWriters: readonly StageSpec[];
+    readonly catalog: string;
+    readonly deployTarget: string;
+};
+/**
+ * Contract analysis only: physical inventory and executable capabilities are
+ * separate planner gates. A clean report is never authorization to mutate.
+ * External writers exclude ONLY the exact participating repositories;
+ * combining proposed releases retains the existing shared-writer rules.
+ */
+export declare function analyzeMigrationContracts(input: AnalysisInput): MigrationContractReport;
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/migrations/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/migrations/contracts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAExE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAA;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,oBAAoB,CAAA;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAC/C;AAID,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,6BAA6B,EAAE,CAAA;IAC/D,QAAQ,CAAC,eAAe,EAAE,SAAS,SAAS,EAAE,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,CAAA;AAUD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,uBAAuB,CAYvF"}