import { spawnSync } from 'node:child_process' import { join } from 'node:path' import { describe, expect, it } from 'vitest' // C232 — the cataloguing CLI's fail-closed write guards, exercised as a // subprocess: each refusal must happen before any engine call or DB connection. // C245 adds the metadata-only lane, whose guards stop at the intent flag and // the declared target — no S3 and no vision engine on that path. const repoRoot = process.cwd() const scriptPath = join(repoRoot, 'scripts', 'catalog-archive-photos.mjs') const run = (args: string[], env: Record = {}) => spawnSync(process.execPath, [scriptPath, ...args], { cwd: repoRoot, encoding: 'utf8', timeout: 30_000, env: { ...process.env, NODE_OPTIONS: '--no-deprecation --import=tsx/esm --import=./scripts/seed-loader.mjs', NODE_ENV: 'production', VITEST: '', DATABASE_URL: 'postgresql://teqo:teqo@127.0.0.1:5432/teqo_1313', PAYLOAD_SECRET: 'test-secret', ARCHIVE_CATALOG_CONFIRM: '', ARCHIVE_VISION_BASE_URL: '', ARCHIVE_VISION_MODEL: '', ARCHIVE_VISION_ALLOW_REMOTE: '', TEQO_ENV: '', ALLOW_REMOTE_DB: '', S3_BUCKET: '', S3_ENDPOINT: '', S3_ACCESS_KEY_ID: '', S3_SECRET_ACCESS_KEY: '', ...env, }, }) const output = (result: ReturnType) => `${result.stdout}${result.stderr}` const withS3 = { S3_BUCKET: 'bucket', S3_ENDPOINT: 'http://127.0.0.1:3900', S3_ACCESS_KEY_ID: 'key', S3_SECRET_ACCESS_KEY: 'secret', } describe('archive:catalog write guards (C232)', () => { it('prints the help even without a database', () => { const result = run(['--help'], { DATABASE_URL: '' }) expect(result.status).toBe(0) expect(result.stdout).toContain('ARCHIVE_CATALOG_CONFIRM') expect(result.stdout).toContain('ARCHIVE_VISION_BASE_URL') }) it('refuses --apply on a production target without the intent flag', () => { const result = run(['--apply']) expect(result.status).toBe(1) expect(output(result)).toContain('ARCHIVE_CATALOG_CONFIRM=1') }) it('requires the declared TEQO_ENV once the intent flag is set', () => { const result = run(['--apply'], { ARCHIVE_CATALOG_CONFIRM: '1' }) expect(result.status).toBe(1) expect(output(result)).toContain('TEQO_ENV') }) it('refuses a target database that does not match the declared environment', () => { const result = run(['--apply'], { ARCHIVE_CATALOG_CONFIRM: '1', TEQO_ENV: 'staging' }) expect(result.status).toBe(1) expect(output(result)).toContain('≠ "teqo_staging"') }) it('refuses --apply without the complete S3_* set on a declared production target', () => { const result = run(['--apply'], { ARCHIVE_CATALOG_CONFIRM: '1', TEQO_ENV: 'production' }) expect(result.status).toBe(1) expect(output(result)).toContain('S3_BUCKET') }) it('refuses --apply without the vision endpoint', () => { const result = run(['--apply'], { ARCHIVE_CATALOG_CONFIRM: '1', TEQO_ENV: 'production', ...withS3, }) expect(result.status).toBe(1) expect(output(result)).toContain('ARCHIVE_VISION_BASE_URL') }) it('refuses a public vision host without the explicit remote escape', () => { const result = run(['--apply'], { ARCHIVE_CATALOG_CONFIRM: '1', TEQO_ENV: 'production', ARCHIVE_VISION_BASE_URL: 'https://api.example.com/v1', ...withS3, }) expect(result.status).toBe(1) expect(output(result)).toContain('host público') expect(output(result)).toContain('ARCHIVE_VISION_ALLOW_REMOTE') }) it('requires the model once the private endpoint is accepted', () => { const result = run(['--apply'], { ARCHIVE_CATALOG_CONFIRM: '1', TEQO_ENV: 'production', ARCHIVE_VISION_BASE_URL: 'http://100.94.122.26:11434/v1', ...withS3, }) expect(result.status).toBe(1) expect(output(result)).toContain('ARCHIVE_VISION_MODEL') }) it('refuses an unknown argument before touching anything', () => { const result = run(['--force']) expect(result.status).toBe(1) expect(output(result)).toContain('argumento desconhecido') }) it('refuses the metadata-only --apply without the intent flag', () => { const result = run(['--metadata-only', '--apply']) expect(result.status).toBe(1) expect(output(result)).toContain('ARCHIVE_CATALOG_CONFIRM=1') }) // This is the one CLI case that gets past the guards and boots Payload before // the DB refusal; a busy full-suite run can push it past the default 5s. it('metadata-only --apply skips the S3 and vision guards entirely', () => { const result = run(['--metadata-only', '--apply'], { ARCHIVE_CATALOG_CONFIRM: '1', TEQO_ENV: 'production', // A closed port: the guards pass and the boot fails on the DB, proving // the run got past them without demanding S3 or the engine. DATABASE_URL: 'postgresql://teqo:teqo@127.0.0.1:1/teqo_1313', ARCHIVE_VISION_BASE_URL: 'https://api.example.com/v1', }) expect(result.status).toBe(1) const text = output(result) // Positive proof the run got PAST the guards and died on the database: expect(text).toMatch(/ECONNREFUSED|cannot connect to Postgres/) expect(text).not.toContain('S3_BUCKET') expect(text).not.toContain('host público') expect(text).not.toContain('ARCHIVE_VISION_MODEL') }, 60_000) })