gstack/test/ship-queue-train-stamp.test.ts

/**
 * Stamped train prefixes (lib/ship-queue-train-stamp.ts): S_i = stamp(merge(S_(i-1), pin_i)) keeps every
 * earlier release, folds only slot i's own fragments (stacked pins included), runs the versions in ORDER
 * with each slot's effective bump, and a tampered earlier entry or a product change is refused.
 */
import { afterEach, describe, expect, test } from 'bun:test';
import * as fs from 'node:fs';
import * as path from 'node:path';
import { mergePolicy } from '../lib/ship-policy';
import { buildChain } from '../lib/ship-queue-train';
import { stampChain, stampMismatch, type StampChainOptions } from '../lib/ship-queue-train-stamp';
import type { TrainSlot } from '../lib/ship-queue-train-record';
import { BASE_POLICY, cleanup, makeFixtureRepo, type FixtureRepo } from './helpers/restamp-fixture';

const POLICY = { ...BASE_POLICY, release_tool: null, release_outputs: [], changelog_fragments: { dir: 'changelog.d' }, min_gstack_version: '1.91.336.0' };
const repos: FixtureRepo[] = [];
afterEach(() => { while (repos.length) cleanup(repos.pop()!); });

function pin(r: FixtureRepo, name: string, from: string, fragment: string): string {
  r.git('checkout', '-q', '-B', name, from);
  fs.writeFileSync(path.join(r.work, name + '.txt'), name + '\n');
  fs.mkdirSync(path.join(r.work, 'changelog.d'), { recursive: true });
  fs.writeFileSync(path.join(r.work, 'changelog.d', name + '.md'), fragment);
  r.git('add', '-A'); r.git('commit', '-q', '-m', name);
  return r.git('rev-parse', 'HEAD');
}
function chain(r: FixtureRepo, heads: Array<[string, string]>): StampChainOptions {
  const baseSha = r.git('rev-parse', 'origin/main');
  const slots = heads.map(([pr, head]) => ({ pr, head, ready_at: '2026-10-29T00:00:00Z', screen: { mode: 'none' } }) as unknown as TrainSlot);
  const policy = mergePolicy(POLICY, 'test').policy;
  const built = buildChain(r.work, baseSha, slots, policy);
  if (!('prefixes' in built)) throw new Error('chain conflicted');
  return { repoRoot: r.work, base: 'main', policy, policyLabel: 'test', baseSha, slots, plain: built.prefixes, allowRepoCommands: false, now: new Date('2026-10-29T12:00:00Z') };
}
const show = (r: FixtureRepo, rev: string) => r.git('show', rev);

describe('stamped train prefixes', () => {
  test('independent pins: S2 keeps S1\'s release, versions run in order with each slot\'s bump, fragments are gone', () => {
    const r = makeFixtureRepo({ policy: POLICY, prefix: 'train-stamp-' }); repos.push(r);
    const a = pin(r, 'a', 'origin/main', '- a change\n');
    const b = pin(r, 'b', 'origin/main', '---\nbump: minor\n---\n- b change\n');
    const o = chain(r, [['1', a], ['2', b]]);
    const out = stampChain(o);
    if ('code' in out) throw new Error(out.message);
    expect(out.stamped.map(s => s.version)).toEqual(['1.2.4.0', '1.3.0.0']);
    const s2 = out.stamped[1]!.commit;
    expect(show(r, s2 + ':VERSION')).toBe('1.3.0.0');
    const cl = show(r, s2 + ':CHANGELOG.md');
    expect(cl.indexOf('## [1.3.0.0] - 2026-10-29')).toBeLessThan(cl.indexOf('## [1.2.4.0] - 2026-10-29'));
    expect(cl).toContain('- a change');
    expect(cl).toContain('- b change');
    expect(r.git('ls-tree', '-r', '--name-only', s2, '--', 'changelog.d')).toBe('');
    expect(r.git('rev-parse', s2 + '^1')).toBe(out.stamped[0]!.commit);
    expect(r.git('rev-parse', s2 + '^2')).toBe(b);
  }, 60_000);

  test('stacked pins: the child folds only its own fragment; the parent\'s entry appears once', () => {
    const r = makeFixtureRepo({ policy: POLICY, prefix: 'train-stamp-' }); repos.push(r);
    const p = pin(r, 'p', 'origin/main', '- parent change\n');
    const c = pin(r, 'c', p, '- child change\n');
    const out = stampChain(chain(r, [['1', p], ['2', c]]));
    if ('code' in out) throw new Error(out.message);
    const cl = show(r, out.stamped[1]!.commit + ':CHANGELOG.md');
    expect(cl.split('- parent change').length).toBe(2);
    const top = cl.slice(cl.indexOf('## [1.2.5.0]'), cl.indexOf('## [1.2.4.0]'));
    expect(top).toContain('- child change');
    expect(top).not.toContain('- parent change');
  }, 60_000);

  test('a base with a four-part package.json listed in stamp_files keeps four parts in every S_i, read from S_(i-1)', () => {
    const policy = { ...POLICY, stamp_files: ['VERSION', 'package.json', 'CHANGELOG.md', 'changelog.d/*.md'], stamp_patterns: ['"version": "{version}"'] };
    const r = makeFixtureRepo({ policy, prefix: 'train-stamp-' }); repos.push(r);
    const pkg = JSON.parse(fs.readFileSync(path.join(r.work, 'package.json'), 'utf8'));
    fs.writeFileSync(path.join(r.work, 'package.json'), JSON.stringify({ ...pkg, version: '1.2.3.0' }, null, 2) + '\n');
    fs.rmSync(path.join(r.work, 'package-lock.json'));
    r.git('add', '-A'); r.git('commit', '-q', '-m', 'four-part manifest'); r.git('push', '-q', 'origin', 'main');
    const a = pin(r, 'a', 'origin/main', '- a change\n');
    const b = pin(r, 'b', 'origin/main', '- b change\n');
    const o = { ...chain(r, [['1', a], ['2', b]]), policy: mergePolicy(policy, 'test').policy };
    const out = stampChain(o);
    if ('code' in out) throw new Error(out.message);
    expect(out.stamped.map(s => JSON.parse(show(r, s.commit + ':package.json')).version)).toEqual(['1.2.4.0', '1.2.5.0']);
  }, 60_000);

  test('a pin\'s manifest edit beside the version line survives the predecessor\'s bump', () => {
    const r = makeFixtureRepo({ policy: POLICY, prefix: 'train-stamp-' }); repos.push(r);
    const a = pin(r, 'a', 'origin/main', '- a change\n');
    r.git('checkout', '-q', '-B', 'b', 'origin/main');
    const file = path.join(r.work, 'package.json');
    fs.writeFileSync(file, JSON.stringify({ ...JSON.parse(fs.readFileSync(file, 'utf8')), name: 'fixture-b' }, null, 2) + '\n');
    fs.mkdirSync(path.join(r.work, 'changelog.d'), { recursive: true });
    fs.writeFileSync(path.join(r.work, 'changelog.d', 'b.md'), '- b change\n');
    r.git('add', '-A'); r.git('commit', '-q', '-m', 'b');
    const out = stampChain(chain(r, [['1', a], ['2', r.git('rev-parse', 'HEAD')]]));
    if ('code' in out) throw new Error(out.message);
    const s1 = JSON.parse(show(r, out.stamped[0]!.commit + ':package.json'));
    const s2 = JSON.parse(show(r, out.stamped[1]!.commit + ':package.json'));
    expect(s1.version).toBe('1.2.4');
    expect(s2).toMatchObject({ name: 'fixture-b', version: '1.2.5', dependencies: { 'left-pad': '1.2.3' } });
  }, 60_000);

  test('a pin whose CHANGELOG is a symlink refuses before the stamp writes anything outside', () => {
    const r = makeFixtureRepo({ policy: POLICY, prefix: 'train-stamp-' }); repos.push(r);
    const outside = path.join(r.root, 'outside.md');
    fs.writeFileSync(outside, 'keep\n');
    r.git('checkout', '-q', '-B', 'l', 'origin/main');
    fs.rmSync(path.join(r.work, 'CHANGELOG.md'));
    fs.symlinkSync(outside, path.join(r.work, 'CHANGELOG.md'));
    fs.mkdirSync(path.join(r.work, 'changelog.d'), { recursive: true });
    fs.writeFileSync(path.join(r.work, 'changelog.d', 'l.md'), '- l change\n');
    r.git('add', '-A'); r.git('commit', '-q', '-m', 'l');
    const out = stampChain(chain(r, [['1', r.git('rev-parse', 'HEAD')]]));
    expect('code' in out ? out.message : 'stamped').toMatch(/CHANGELOG\.md is a symlink in the merged tree/);
    expect(fs.readFileSync(outside, 'utf8')).toBe('keep\n');
  }, 60_000);

  test('a tampered earlier version or a product change in S_i is refused', () => {
    const r = makeFixtureRepo({ policy: POLICY, prefix: 'train-stamp-' }); repos.push(r);
    const a = pin(r, 'a', 'origin/main', '- a change\n');
    const b = pin(r, 'b', 'origin/main', '- b change\n');
    const o = chain(r, [['1', a], ['2', b]]);
    const out = stampChain(o);
    if ('code' in out) throw new Error(out.message);
    const s1 = out.stamped[0]!.commit;
    const s2 = out.stamped[1]!;
    const merged = r.git('commit-tree', r.git('merge-tree', '--write-tree', b, s1).split('\n')[0]!, '-p', s1, '-p', b, '-m', 'm');
    expect(stampMismatch(o, merged, s2.commit, o.plain[2]!.tree)).toBeNull();
    const tamper = (file: string, edit: (t: string) => string) => {
      r.git('checkout', '-q', '-f', '--detach', s2.commit);
      fs.writeFileSync(path.join(r.work, file), edit(fs.readFileSync(path.join(r.work, file), 'utf8')));
      r.git('add', '-A');
      return r.git('commit-tree', r.git('write-tree'), '-p', s1, '-p', b, '-m', 'tampered');
    };
    const older = tamper('CHANGELOG.md', t => t.replace('## [1.2.4.0]', '## [1.2.3.9]'));
    expect(stampMismatch(o, merged, older, o.plain[2]!.tree)).toContain('the stamp rewrote or dropped the earlier release entry [1.2.4.0] in CHANGELOG.md');
    const product = tamper('a.txt', () => 'not a\n');
    expect(stampMismatch(o, merged, product, o.plain[2]!.tree)).toContain('a.txt');
  }, 60_000);

  // Value: protects=the train's stamp check bounds a branch-added row the same way the train restamp writes it, so a pin
  //   with a row left at the fork version still stamps; fails_when=stampMismatch reads that row against the pin's own
  //   VERSION and refuses the moved row; seam=lib/ship-queue-train-stamp.ts stampMismatch baseRef (GST-963)
  test('a pin claiming 1.2.4.0 with a stamp_paths row left at the base 1.2.3.0 stamps, and the row moves (GST-963)', () => {
    const r = makeFixtureRepo({ policy: POLICY, prefix: 'train-stamp-' }); repos.push(r);
    pin(r, 'f', 'origin/main', '- f change\n');
    fs.writeFileSync(path.join(r.work, 'VERSION'), '1.2.4.0\n');
    fs.writeFileSync(path.join(r.work, 'docs', 'f.md'), '// since: 1.2.3.0\n');
    r.git('add', '-A'); r.git('commit', '-q', '-m', 'f: claims 1.2.4.0, row at the fork version');
    const out = stampChain(chain(r, [['1', r.git('rev-parse', 'HEAD')]]));
    if ('code' in out) throw new Error(`${out.code}: ${out.message}`);
    expect(out.stamped.map(s => s.version)).toEqual(['1.2.4.0']);
    expect(show(r, out.stamped[0]!.commit + ':docs/f.md')).toBe('// since: 1.2.4.0');
  }, 60_000);

  // Value: protects=a slot whose own claim is above the version the train gives it still moves its built-in-form row,
  //   because the claim is read from the pin's own commits through the train merge (GST-1245 red team); fails_when=the
  //   recorded versions walk only the merge's first parent (the predecessor), so the row stays at the stale claim and
  //   the train's own receipt passes it; seam=lib/restamp.ts recordedVersions via stampChain and stampMismatch
  test('a pin claiming 1.2.6.0 above its slot\'s 1.2.5.0 moves its own since: 1.2.6.0 row (GST-1245)', () => {
    const r = makeFixtureRepo({ policy: POLICY, prefix: 'train-stamp-' }); repos.push(r);
    pin(r, 'g', 'origin/main', '- g change\n');
    r.git('checkout', '-q', '--detach', 'origin/main');
    fs.writeFileSync(path.join(r.work, 'VERSION'), '1.2.4.0\n');
    r.git('commit', '-qam', 'main releases 1.2.4.0'); r.git('push', '-q', 'origin', 'HEAD:refs/heads/main'); r.git('fetch', '-q', 'origin');
    r.git('checkout', '-q', 'g');
    fs.writeFileSync(path.join(r.work, 'VERSION'), '1.2.6.0\n');
    fs.writeFileSync(path.join(r.work, 'docs', 'g.md'), '// since: 1.2.6.0\nQM v9.9.9.0 stays\n');
    r.git('add', '-A'); r.git('commit', '-q', '-m', 'g: claims 1.2.6.0, row at its claim, a foreign version beside it');
    const out = stampChain(chain(r, [['1', r.git('rev-parse', 'HEAD')]]));
    if ('code' in out) throw new Error(`${out.code}: ${out.message}`);
    expect(out.stamped.map(s => s.version)).toEqual(['1.2.5.0']);
    expect(show(r, out.stamped[0]!.commit + ':docs/g.md')).toBe('// since: 1.2.5.0\nQM v9.9.9.0 stays');
  }, 60_000);
});