@sequenceholdings/pipeline-spec 0.1.0

package/dist/migrations/contracts.js

@@ -0,0 +1,175 @@
+import { requireResolvedColumns } from '../columns.js';
+import { diffContracts } from '../diff.js';
+import { validateWriteOwnership } from '../graph.js';
+import { canonicalJson } from '../hash.js';
+import { transformationOutputCatalog } from '../resolve.js';
+const referenceKey = (repo, stage, output, column) => canonicalJson([repo, stage, output, column]);
+/**
+ * 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 function analyzeMigrationContracts(input) {
+    const analysis = { ...input, findings: [], changes: [], declarations: new Map(), consumed: new Set() };
+    validateParticipants(analysis);
+    collectDeclarations(analysis);
+    validateCheckReferences(analysis);
+    validateBaselineReferences(analysis);
+    for (const participant of input.participants)
+        analyzeParticipant({ analysis, participant });
+    if (input.manifest) {
+        for (const key of analysis.declarations.keys())
+            if (!analysis.consumed.has(key))
+                analysis.findings.push({ code: 'migration_change_unmatched', severity: 'error', message: `declared change ${key} does not match a deployed-to-proposed column transition` });
+        for (const finding of validateWriteOwnership(input.participants.flatMap((participant) => participant.after), { catalog: input.catalog, deployTarget: input.deployTarget, externalStages: input.externalWriters }))
+            analysis.findings.push({ code: 'migration_writer_conflict', severity: 'error', stage: finding.stage, message: finding.message });
+    }
+    return { changes: analysis.changes, findings: analysis.findings };
+}
+function validateParticipants({ participants, rootRepo, manifest, findings }) {
+    const repos = new Set(participants.map((participant) => participant.repo));
+    if (repos.size !== participants.length || !repos.has(rootRepo))
+        findings.push({ code: 'migration_participants_invalid', severity: 'error', message: 'participants must contain the root repository exactly once and have unique repositories' });
+    if (!manifest)
+        return;
+    const expected = new Set([rootRepo, ...manifest.participants.map((item) => item.repo)]);
+    if (manifest.participants.some((item) => item.repo === rootRepo) || expected.size !== repos.size || [...expected].some((repo) => !repos.has(repo)))
+        findings.push({ code: 'migration_participants_invalid', severity: 'error', message: 'materialized participants must match the root and every declared participant exactly' });
+}
+function collectDeclarations({ manifest, rootRepo, declarations, findings }) {
+    for (const item of manifest?.changes ?? []) {
+        for (const column of item.columns) {
+            const key = referenceKey(item.repo ?? rootRepo, item.stage, item.output, column);
+            if (declarations.has(key))
+                findings.push({ code: 'migration_change_duplicate', severity: 'error', message: `duplicate migration change for '${item.stage}.${item.output}.${column}'` });
+            declarations.set(key, item.kind);
+        }
+    }
+}
+function validateCheckReferences({ manifest, participants, rootRepo, findings }) {
+    if (!manifest)
+        return;
+    for (const item of [...manifest.rebuild, ...manifest.checks]) {
+        if (!('stage' in item)) {
+            if (!manifest.orm.some((project) => project.namespace === item.namespace))
+                findings.push({ code: 'migration_orm_missing', severity: 'error', message: `ORM operation check requires a pinned project for namespace '${item.namespace}'` });
+            continue;
+        }
+        const repo = item.repo ?? rootRepo;
+        const stage = participants.find((participant) => participant.repo === repo)?.after.find((stage) => stage.stage === item.stage);
+        if (!stage || stage.type !== 'transformation') {
+            findings.push({ code: 'migration_stage_missing', severity: 'error', repo, stage: item.stage, message: `migration references missing transformation '${repo}:${item.stage}'` });
+            continue;
+        }
+        if (!('output' in item))
+            continue;
+        const output = stage.outputs[item.output];
+        if (!output) {
+            findings.push({ code: 'migration_output_missing', severity: 'error', repo, stage: item.stage, output: item.output, message: `migration check references missing output '${item.output}'` });
+            continue;
+        }
+        if (item.kind !== 'unchanged_values')
+            continue;
+        const columns = requireResolvedColumns(output.columns, `${stage.stage}.${item.output}`);
+        for (const column of item.columns)
+            if (!columns[column])
+                findings.push({ code: 'migration_check_column_missing', severity: 'error', repo, stage: item.stage, output: item.output, column, message: `unchanged-values check references missing column '${column}'` });
+    }
+}
+function validateBaselineReferences({ manifest, participants, rootRepo, findings }) {
+    const seen = new Set();
+    for (const item of manifest?.baseline ?? []) {
+        const repo = item.repo ?? rootRepo;
+        const key = canonicalJson([repo, item.stage, item.output]);
+        const release = participants.find((participant) => participant.repo === repo);
+        const before = release?.before.find((spec) => spec.stage === item.stage);
+        const after = release?.after.find((spec) => spec.stage === item.stage);
+        const oldOutput = before?.type === 'transformation' ? before.outputs[item.output] : undefined;
+        const newOutput = after?.type === 'transformation' ? after.outputs[item.output] : undefined;
+        const oldColumns = oldOutput ? requireResolvedColumns(oldOutput.columns, `${item.stage}.${item.output}`) : {};
+        const newColumns = newOutput ? requireResolvedColumns(newOutput.columns, `${item.stage}.${item.output}`) : {};
+        const invalidColumns = item.adopt_existing
+            ? !before || Boolean(oldOutput) || !newOutput || canonicalJson(Object.keys(item.columns).sort()) !== canonicalJson(Object.keys(newColumns).sort()) || Object.entries(item.columns).some(([name, type]) => type !== newColumns[name]?.type)
+            : Object.keys(item.columns).some((column) => !oldColumns[column] || !newColumns[column]);
+        if (seen.has(key) || !manifest.rebuild.some((rebuild) => (rebuild.repo ?? rootRepo) === repo && rebuild.stage === item.stage)
+            || invalidColumns) {
+            findings.push({ code: 'migration_baseline_invalid', severity: 'error', repo, stage: item.stage, output: item.output,
+                message: item.adopt_existing ? 'adoption must describe every unchanged column of a newly declared output on an existing rebuilt stage' : 'baseline corrections must uniquely reference existing columns of participating rebuilt outputs' });
+        }
+        seen.add(key);
+    }
+}
+function analyzeParticipant({ analysis, participant }) {
+    if (analysis.manifest) {
+        for (const before of participant.before) {
+            const after = participant.after.find((stage) => stage.stage === before.stage);
+            if (!after || after.type !== before.type)
+                analysis.findings.push({ code: 'migration_change_unsupported', severity: 'error', repo: participant.repo, stage: before.stage, message: `removing or replacing stage '${before.stage}' is not a column migration` });
+        }
+    }
+    const beforeByStage = new Map(participant.before.map((spec) => [spec.stage, spec]));
+    for (const proposed of participant.after) {
+        const before = beforeByStage.get(proposed.stage);
+        // First creation uses the normal deployment path.
+        if (before?.type !== 'transformation' || proposed.type !== 'transformation')
+            continue;
+        for (const [output, diff] of Object.entries(diffContracts(before, proposed).outputs))
+            analyzeOutput({ analysis, repo: participant.repo, before, proposed, output, diff });
+    }
+}
+function validateOutputRebuild({ analysis, context, before, proposed }) {
+    const { manifest, findings, rootRepo, catalog, deployTarget } = analysis;
+    if (!manifest)
+        return;
+    const output = proposed.outputs[context.output];
+    if (proposed.engine !== 'spark-job' || output.write_pattern !== 'overwrite')
+        findings.push({ ...context, code: 'migration_engine_unsupported', severity: 'error', message: 'V1 requires a Spark job capable of fully rebuilding the affected writer scope' });
+    if (!manifest.rebuild.some((item) => (item.repo ?? rootRepo) === context.repo && item.stage === proposed.stage))
+        findings.push({ ...context, code: 'migration_rebuild_missing', severity: 'error', message: `declare a full_writer_scope rebuild for '${context.repo}:${proposed.stage}'` });
+    if (transformationOutputCatalog(before, catalog, deployTarget) !== transformationOutputCatalog(proposed, catalog, deployTarget))
+        findings.push({ ...context, code: 'migration_target_changed', severity: 'error', message: 'moving an output to a different physical catalog is not a column migration' });
+}
+function analyzeOutput({ analysis, repo, before, proposed, output, diff }) {
+    const oldOutput = before.outputs[output];
+    const newOutput = proposed.outputs[output];
+    // New outputs are provisioned after their producer runs. Removed outputs
+    // cannot be legitimized by declaring a migration for another column.
+    if (!oldOutput)
+        return;
+    const context = { repo, stage: proposed.stage, output, physicalTable: `${transformationOutputCatalog(proposed, analysis.catalog, analysis.deployTarget)}.${output}` };
+    const supported = diff.changes.filter((change) => change.code === 'column_added' || change.code === 'type_changed');
+    if (analysis.manifest) {
+        for (const change of diff.changes) {
+            if (change.code === 'column_added' || change.code === 'type_changed' || change.code === 'compatibility_mode_changed')
+                continue;
+            analysis.findings.push({ ...context, column: change.column, code: 'migration_change_unsupported', severity: 'error', message: `${change.message}; this migration supports column additions and type changes only` });
+        }
+    }
+    if (!newOutput || supported.length === 0)
+        return;
+    const oldColumns = requireResolvedColumns(oldOutput.columns, `${before.stage}.${output}`);
+    const newColumns = requireResolvedColumns(newOutput.columns, `${proposed.stage}.${output}`);
+    validateOutputRebuild({ analysis, context, before, proposed });
+    for (const change of supported)
+        recordColumnChange({ analysis, context, change, oldColumns, newColumns, scopeColumn: newOutput.write_scope?.column });
+}
+function recordColumnChange({ analysis, context, change, oldColumns, newColumns, scopeColumn }) {
+    if (!change.column)
+        return;
+    const column = newColumns[change.column];
+    if (!column)
+        return;
+    const kind = change.code === 'column_added' ? 'add_column' : 'change_column_type';
+    if (analysis.manifest && (column.key || oldColumns[change.column]?.key || scopeColumn === change.column))
+        analysis.findings.push({ ...context, column: change.column, code: 'migration_change_unsupported', severity: 'error', message: 'V1 cannot add or change the type of a primary-key or writer-scope column' });
+    const key = referenceKey(context.repo, context.stage, context.output, change.column);
+    analysis.changes.push({ ...context, column: change.column, kind, oldType: oldColumns[change.column]?.type ?? null, newType: column.type });
+    if (!analysis.manifest)
+        return;
+    if (analysis.declarations.get(key) !== kind)
+        analysis.findings.push({ ...context, column: change.column, code: 'migration_change_uncovered', severity: 'error', message: `${change.message}; declare '${kind}' for this column` });
+    else
+        analysis.consumed.add(key);
+}
+//# sourceMappingURL=contracts.js.map

package/dist/migrations/contracts.js.map

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

package/dist/migrations/manifest.d.ts

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+export declare const MIGRATIONS_DIRECTORY = "migrations";
+/** Execution choice belongs to the approved plan, not a mutable start flag. */
+export declare const migrationExecutionModeSchema: z.ZodEnum<{
+    candidate: "candidate";
+    in_place: "in_place";
+}>;
+export type MigrationExecutionMode = z.infer<typeof migrationExecutionModeSchema>;
+export declare const MIGRATION_FILE_PATTERN: RegExp;
+export declare const migrationCheckSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"row_count">;
+    comparison: z.ZodEnum<{
+        equal: "equal";
+        not_less: "not_less";
+    }>;
+    output: z.ZodString;
+    repo: z.ZodOptional<z.ZodString>;
+    stage: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"unchanged_values">;
+    columns: z.ZodArray<z.ZodString>;
+    output: z.ZodString;
+    repo: z.ZodOptional<z.ZodString>;
+    stage: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"sql_assertion">;
+    path: z.ZodString;
+    repo: z.ZodOptional<z.ZodString>;
+    stage: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"orm_operation">;
+    namespace: z.ZodString;
+    operation: z.ZodString;
+}, z.core.$strict>], "kind">;
+export declare const migrationManifestSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    participants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        repo: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strict>>>;
+    baseline: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        adopt_existing: z.ZodOptional<z.ZodLiteral<true>>;
+        columns: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<{
+            string: "string";
+            boolean: "boolean";
+            uuid: "uuid";
+            int: "int";
+            long: "long";
+            numeric: "numeric";
+            double: "double";
+            timestamp: "timestamp";
+            date: "date";
+            json: "json";
+        }>, z.ZodEnum<{
+            float: "float";
+            timestamp_ntz: "timestamp_ntz";
+            array: "array";
+            map: "map";
+            struct: "struct";
+            binary: "binary";
+        }>, z.ZodString]>>;
+        output: z.ZodString;
+        repo: z.ZodOptional<z.ZodString>;
+        stage: z.ZodString;
+    }, z.core.$strict>>>;
+    changes: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            add_column: "add_column";
+            change_column_type: "change_column_type";
+        }>;
+        columns: z.ZodArray<z.ZodString>;
+        output: z.ZodString;
+        repo: z.ZodOptional<z.ZodString>;
+        stage: z.ZodString;
+    }, z.core.$strict>>;
+    rebuild: z.ZodArray<z.ZodObject<{
+        mode: z.ZodLiteral<"full_writer_scope">;
+        repo: z.ZodOptional<z.ZodString>;
+        stage: z.ZodString;
+    }, z.core.$strict>>;
+    orm: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        repo: z.ZodString;
+        ref: z.ZodString;
+        path: z.ZodUnion<readonly [z.ZodLiteral<".">, z.ZodString]>;
+        namespace: z.ZodString;
+    }, z.core.$strict>>>;
+    checks: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"row_count">;
+        comparison: z.ZodEnum<{
+            equal: "equal";
+            not_less: "not_less";
+        }>;
+        output: z.ZodString;
+        repo: z.ZodOptional<z.ZodString>;
+        stage: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unchanged_values">;
+        columns: z.ZodArray<z.ZodString>;
+        output: z.ZodString;
+        repo: z.ZodOptional<z.ZodString>;
+        stage: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"sql_assertion">;
+        path: z.ZodString;
+        repo: z.ZodOptional<z.ZodString>;
+        stage: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"orm_operation">;
+        namespace: z.ZodString;
+        operation: z.ZodString;
+    }, z.core.$strict>], "kind">>>;
+}, z.core.$strict>;
+export type MigrationManifest = z.infer<typeof migrationManifestSchema>;
+export type MigrationCheck = z.infer<typeof migrationCheckSchema>;
+/** Stable predecessor order; referenced history must remain in the repository. */
+export declare function orderMigrationManifests(manifests: readonly MigrationManifest[]): MigrationManifest[];
+export declare function parseMigrationFile(file: string, contents: string): MigrationManifest;
+/** Hash validated semantic contents, not YAML formatting or object key order. */
+export declare function computeMigrationChecksum(manifest: MigrationManifest): string;
+export interface MigrationFinding {
+    readonly code: string;
+    readonly severity: 'error' | 'warning';
+    readonly message: string;
+    readonly repo?: string;
+    readonly stage?: string;
+    readonly output?: string;
+    readonly column?: string;
+    readonly physicalTable?: string;
+}
+/** The caller supplies successful history for this root repository and target only. */
+export declare function validateMigrationHistory(manifest: MigrationManifest, applied: readonly {
+    id: string;
+    checksum: string;
+}[]): MigrationFinding[];
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/migrations/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAYvB,eAAO,MAAM,oBAAoB,eAAe,CAAA;AAChD,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B;;;EAAoC,CAAA;AAC7E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACjF,eAAO,MAAM,sBAAsB,QAA2C,CAAA;AAQ9E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;4BAQ/B,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqClC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAmBpG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAYpF;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAE5E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,uFAAuF;AACvF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,gBAAgB,EAAE,CAQ9I"}

package/dist/migrations/manifest.js

@@ -0,0 +1,137 @@
+import { createHash } from 'node:crypto';
+import { load as loadYaml } from 'js-yaml';
+import { z } from 'zod';
+import { repoRelativePathSchema } from '../bodies/ingestion.js';
+import { outputAssetNameSchema } from '../bodies/transformation.js';
+import { columnIdentifierSchema, identifierSchema } from '../columns.js';
+import { MAX_SPEC_FILE_BYTES } from '../constants.js';
+import { stageIdSchema } from '../envelope.js';
+import { SpecDefinitionError } from '../errors.js';
+import { canonicalJson } from '../hash.js';
+import { formatSpecIssues } from '../issues.js';
+import { scanForCredentialLikeStrings } from '../secret-scan.js';
+import { pipelineTypeSchema } from '../types.js';
+export const MIGRATIONS_DIRECTORY = 'migrations';
+/** Execution choice belongs to the approved plan, not a mutable start flag. */
+export const migrationExecutionModeSchema = z.enum(['candidate', 'in_place']);
+export const MIGRATION_FILE_PATTERN = /^migrations\/([a-z][a-z0-9-]*)\.ya?ml$/;
+const repoSchema = z.string().max(255).regex(/^[a-zA-Z0-9_-]+\/[a-zA-Z0-9_-]+$/, 'must be a namespace/repository name');
+const pipelineRepoSchema = z.string().max(255).regex(/^pipelines\/[a-z][a-z0-9-]*$/, 'must be a pipelines/<domain> repository');
+const refSchema = z.string().min(1).max(255).refine((ref) => !/[\s\x00-\x1f]/.test(ref), 'must be a git revision without whitespace');
+const uniqueColumns = z.array(columnIdentifierSchema).min(1).refine((columns) => new Set(columns).size === columns.length, 'columns must be unique');
+const stageReference = { repo: pipelineRepoSchema.optional(), stage: stageIdSchema };
+const outputReference = { ...stageReference, output: outputAssetNameSchema };
+export const migrationCheckSchema = z.discriminatedUnion('kind', [
+    z.strictObject({ ...outputReference, kind: z.literal('row_count'), comparison: z.enum(['equal', 'not_less']) }),
+    z.strictObject({ ...outputReference, kind: z.literal('unchanged_values'), columns: uniqueColumns }),
+    // Files are read at the pinned commit. The executor uses a read-only identity;
+    // recognizing SELECT text is not a security boundary. Only aggregate pass/fail
+    // evidence is retained, never arbitrary query results or example customer rows.
+    z.strictObject({ ...stageReference, kind: z.literal('sql_assertion'), path: repoRelativePathSchema }),
+    z.strictObject({ kind: z.literal('orm_operation'), namespace: identifierSchema, operation: z.string().regex(/^[_A-Za-z][_0-9A-Za-z]*$/, 'must be a GraphQL operation name') }),
+]);
+export const migrationManifestSchema = z.strictObject({
+    schema_version: z.literal(1),
+    id: stageIdSchema,
+    depends_on: z.array(stageIdSchema).default([]),
+    participants: z.array(z.strictObject({ repo: pipelineRepoSchema, ref: refSchema })).default([]),
+    /** Explicit observed types when an earlier deployment declaration was wrong.
+     * These describe the starting state, never a second source of desired types.
+     * Optional (no default) preserves the checksums of historical manifests.
+     */
+    baseline: z.array(z.strictObject({
+        ...outputReference,
+        /** Register an existing, previously undeclared output without changing
+         * its data contract. Every physical column must be described. */
+        adopt_existing: z.literal(true).optional(),
+        columns: z.record(columnIdentifierSchema, pipelineTypeSchema).refine((columns) => Object.keys(columns).length > 0, 'baseline needs at least one observed column'),
+    })).min(1).optional(),
+    changes: z.array(z.strictObject({
+        ...outputReference,
+        kind: z.enum(['add_column', 'change_column_type']),
+        columns: uniqueColumns,
+    })).min(1),
+    rebuild: z.array(z.strictObject({ ...stageReference, mode: z.literal('full_writer_scope') })).min(1),
+    orm: z.array(z.strictObject({ repo: repoSchema, ref: refSchema, path: z.union([z.literal('.'), repoRelativePathSchema]), namespace: identifierSchema })).default([]),
+    checks: z.array(migrationCheckSchema).default([]),
+}).superRefine((manifest, ctx) => {
+    const unique = (values, path) => {
+        if (new Set(values).size !== values.length)
+            ctx.addIssue({ code: 'custom', path: [path], message: `duplicate migration ${path} declaration` });
+    };
+    unique(manifest.depends_on, 'depends_on');
+    if (manifest.depends_on.includes(manifest.id))
+        ctx.addIssue({ code: 'custom', path: ['depends_on'], message: 'a migration cannot depend on itself' });
+    unique(manifest.participants.map((participant) => participant.repo), 'participants');
+    unique(manifest.orm.map((project) => project.namespace), 'orm');
+    unique(manifest.rebuild.map((item) => canonicalJson([item.repo ?? '', item.stage])), 'rebuild');
+    unique((manifest.baseline ?? []).map((item) => canonicalJson([item.repo ?? '', item.stage, item.output])), 'baseline');
+    // One operation per column, including conflicting kinds, must be unambiguous.
+    unique(manifest.changes.flatMap((item) => item.columns.map((column) => canonicalJson([item.repo ?? '', item.stage, item.output, column]))), 'changes');
+    for (const finding of scanForCredentialLikeStrings(manifest))
+        ctx.addIssue({ code: 'custom', path: [...finding.segments], message: finding.reason });
+});
+/** Stable predecessor order; referenced history must remain in the repository. */
+export function orderMigrationManifests(manifests) {
+    const byId = new Map(manifests.map((manifest) => [manifest.id, manifest]));
+    if (byId.size !== manifests.length)
+        throw new SpecDefinitionError('duplicate migration id');
+    const ordered = [];
+    const visiting = [];
+    const visited = new Set();
+    const visit = (id) => {
+        if (visited.has(id))
+            return;
+        if (visiting.includes(id))
+            throw new SpecDefinitionError(`migration dependency cycle: ${[...visiting, id].join(' → ')}`);
+        const manifest = byId.get(id);
+        if (!manifest)
+            throw new SpecDefinitionError(`migration predecessor '${id}' is missing; retain applied migration files in the repository`);
+        visiting.push(id);
+        for (const predecessor of [...manifest.depends_on].sort())
+            visit(predecessor);
+        visiting.pop();
+        visited.add(id);
+        ordered.push(manifest);
+    };
+    for (const id of [...byId.keys()].sort())
+        visit(id);
+    return ordered;
+}
+export function parseMigrationFile(file, contents) {
+    const match = MIGRATION_FILE_PATTERN.exec(file);
+    if (!match)
+        throw new SpecDefinitionError('expected migrations/<id>.yml', file);
+    if (Buffer.byteLength(contents, 'utf8') > MAX_SPEC_FILE_BYTES)
+        throw new SpecDefinitionError(`exceeds the maximum spec file size of ${MAX_SPEC_FILE_BYTES} bytes`, file);
+    let source;
+    try {
+        source = loadYaml(contents);
+    }
+    catch (error) {
+        throw new SpecDefinitionError(error instanceof Error ? error.message : 'invalid YAML', file);
+    }
+    const parsed = migrationManifestSchema.safeParse(source);
+    if (!parsed.success)
+        throw new SpecDefinitionError(formatSpecIssues(parsed.error), file);
+    if (parsed.data.id !== match[1])
+        throw new SpecDefinitionError(`migration id '${parsed.data.id}' must match the file basename '${match[1]}'`, file, 'id');
+    return parsed.data;
+}
+/** Hash validated semantic contents, not YAML formatting or object key order. */
+export function computeMigrationChecksum(manifest) {
+    return createHash('sha256').update('pipeline-migration:v1\0').update(canonicalJson(manifest)).digest('hex');
+}
+/** The caller supplies successful history for this root repository and target only. */
+export function validateMigrationHistory(manifest, applied) {
+    const findings = [];
+    const existing = applied.find((entry) => entry.id === manifest.id);
+    if (existing && existing.checksum !== computeMigrationChecksum(manifest))
+        findings.push({ code: 'migration_id_changed', severity: 'error', message: `applied migration '${manifest.id}' has different contents; create a new migration id` });
+    for (const predecessor of manifest.depends_on) {
+        if (!applied.some((entry) => entry.id === predecessor))
+            findings.push({ code: 'migration_predecessor_missing', severity: 'error', message: `migration '${predecessor}' must succeed in this target before '${manifest.id}'` });
+    }
+    return findings;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/migrations/manifest.js.map

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