portal-template-default/.github/scripts/tests/patch-flow.test.mjs

import assert from 'node:assert/strict';
import { execFileSync } from 'node:child_process';
import {
  existsSync,
  mkdtempSync,
  mkdirSync,
  readFileSync,
  rmSync,
  writeFileSync,
} from 'node:fs';
import os from 'node:os';
import path from 'node:path';
import test from 'node:test';

const scripts = path.resolve(import.meta.dirname, '..');

test('patch flow preserves new and modified files', () => {
  const root = mkdtempSync(path.join(os.tmpdir(), 'nb3-factory-patch-'));
  const source = path.join(root, 'source');
  const publisher = path.join(root, 'publisher');
  const patch = path.join(root, 'bundle', 'agent.patch');
  const summary = path.join(root, 'bundle', 'summary.json');

  try {
    mkdirSync(source);
    git(source, ['init', '--initial-branch=main']);
    git(source, ['config', 'user.name', 'Factory Test']);
    git(source, ['config', 'user.email', '[email protected]']);
    writeFileSync(path.join(source, 'existing.txt'), 'before\n');
    git(source, ['add', '.']);
    git(source, ['commit', '-m', 'initial']);

    execFileSync('git', ['clone', '--quiet', source, publisher]);
    writeFileSync(path.join(source, 'existing.txt'), 'after\n');
    writeFileSync(path.join(source, 'new.txt'), 'new\n');

    execFileSync(
      process.execPath,
      [
        path.join(scripts, 'create-patch.mjs'),
        '--workspace',
        source,
        '--patch',
        patch,
        '--summary',
        summary,
      ],
      { stdio: 'pipe' },
    );
    execFileSync(
      process.execPath,
      [
        path.join(scripts, 'apply-patch.mjs'),
        '--workspace',
        publisher,
        '--patch',
        patch,
        '--branch',
        'agent/issue-1',
      ],
      { stdio: 'pipe' },
    );

    assert.equal(
      readFileSync(path.join(publisher, 'existing.txt'), 'utf8'),
      'after\n',
    );
    assert.equal(
      readFileSync(path.join(publisher, 'new.txt'), 'utf8'),
      'new\n',
    );
    assert.deepEqual(JSON.parse(readFileSync(summary, 'utf8')).counts, {
      added: 1,
      modified: 1,
      deleted: 0,
      renamed: 0,
      files: 2,
    });
  } finally {
    rmSync(root, { recursive: true, force: true });
  }
});

test('patch flow restores protected paths and keeps application changes', () => {
  const root = mkdtempSync(
    path.join(os.tmpdir(), 'nb3-factory-protected-patch-'),
  );
  const source = path.join(root, 'source');
  const publisher = path.join(root, 'publisher');
  const patch = path.join(root, 'bundle', 'agent.patch');
  const summary = path.join(root, 'bundle', 'summary.json');

  try {
    mkdirSync(source);
    git(source, ['init', '--initial-branch=main']);
    git(source, ['config', 'user.name', 'Factory Test']);
    git(source, ['config', 'user.email', '[email protected]']);
    mkdirSync(path.join(source, '.github'), { recursive: true });
    writeFileSync(path.join(source, '.github', 'control.yml'), 'original\n');
    writeFileSync(path.join(source, '.github', 'deleted.yml'), 'restore me\n');
    writeFileSync(path.join(source, '.npmrc'), 'registry=original\n');
    writeFileSync(path.join(source, '.gitignore'), 'config.yml\n');
    writeFileSync(path.join(source, 'app.txt'), 'before\n');
    git(source, ['add', '.']);
    git(source, ['commit', '-m', 'initial']);

    execFileSync('git', ['clone', '--quiet', source, publisher]);
    writeFileSync(path.join(source, 'app.txt'), 'after\n');
    writeFileSync(path.join(source, '.github', 'control.yml'), 'formatted\n');
    rmSync(path.join(source, '.github', 'deleted.yml'));
    writeFileSync(path.join(source, '.github', 'generated.yml'), 'untracked\n');
    writeFileSync(path.join(source, '.npmrc'), 'registry=changed\n');
    writeFileSync(path.join(source, '.gitmodules'), 'untracked\n');
    writeFileSync(path.join(source, 'config.yml'), 'secret: true\n');
    git(source, ['add', '-A']);

    const result = execFileSync(
      process.execPath,
      [
        path.join(scripts, 'create-patch.mjs'),
        '--workspace',
        source,
        '--patch',
        patch,
        '--summary',
        summary,
      ],
      { encoding: 'utf8' },
    );

    assert.match(result, /Created patch with 1 changed file/);
    assert.equal(
      readFileSync(path.join(source, '.github', 'control.yml'), 'utf8'),
      'original\n',
    );
    assert.equal(
      readFileSync(path.join(source, '.github', 'deleted.yml'), 'utf8'),
      'restore me\n',
    );
    assert.equal(
      readFileSync(path.join(source, '.npmrc'), 'utf8'),
      'registry=original\n',
    );
    assert.equal(
      existsSync(path.join(source, '.github', 'generated.yml')),
      false,
    );
    assert.equal(existsSync(path.join(source, '.gitmodules')), false);
    assert.equal(existsSync(path.join(source, 'config.yml')), false);

    execFileSync(
      process.execPath,
      [
        path.join(scripts, 'apply-patch.mjs'),
        '--workspace',
        publisher,
        '--patch',
        patch,
        '--branch',
        'agent/issue-1',
      ],
      { stdio: 'pipe' },
    );
    assert.equal(
      readFileSync(path.join(publisher, 'app.txt'), 'utf8'),
      'after\n',
    );
    assert.deepEqual(JSON.parse(readFileSync(summary, 'utf8')).counts, {
      added: 0,
      modified: 1,
      deleted: 0,
      renamed: 0,
      files: 1,
    });
  } finally {
    rmSync(root, { recursive: true, force: true });
  }
});

test('patch flow can revalidate an unchanged existing work branch', () => {
  const root = mkdtempSync(path.join(os.tmpdir(), 'nb3-factory-empty-patch-'));
  const source = path.join(root, 'source');
  const publisher = path.join(root, 'publisher');
  const patch = path.join(root, 'bundle', 'agent.patch');
  const summary = path.join(root, 'bundle', 'summary.json');

  try {
    mkdirSync(source);
    git(source, ['init', '--initial-branch=main']);
    git(source, ['config', 'user.name', 'Factory Test']);
    git(source, ['config', 'user.email', '[email protected]']);
    writeFileSync(path.join(source, 'existing.txt'), 'unchanged\n');
    git(source, ['add', '.']);
    git(source, ['commit', '-m', 'initial']);
    execFileSync('git', ['clone', '--quiet', source, publisher]);

    execFileSync(
      process.execPath,
      [
        path.join(scripts, 'create-patch.mjs'),
        '--workspace',
        source,
        '--patch',
        patch,
        '--summary',
        summary,
        '--allow-empty',
        'true',
      ],
      { stdio: 'pipe' },
    );
    execFileSync(
      process.execPath,
      [
        path.join(scripts, 'apply-patch.mjs'),
        '--workspace',
        publisher,
        '--patch',
        patch,
        '--branch',
        'agent/issue-1',
      ],
      { stdio: 'pipe' },
    );

    const parsed = JSON.parse(readFileSync(summary, 'utf8'));
    assert.equal(parsed.reusedExistingWorkBranch, true);
    assert.deepEqual(parsed.counts, {
      added: 0,
      modified: 0,
      deleted: 0,
      renamed: 0,
      files: 0,
    });
    assert.equal(
      readFileSync(path.join(publisher, 'existing.txt'), 'utf8'),
      'unchanged\n',
    );
  } finally {
    rmSync(root, { recursive: true, force: true });
  }
});

function git(cwd, args) {
  execFileSync('git', args, { cwd, stdio: 'pipe' });
}