Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

3.4 KB
Raw Blame
import { readdirSync, readFileSync, statSync } from 'node:fs'
import { join, relative } from 'node:path'
import { fileURLToPath } from 'node:url'
import { describe, expect, it } from 'vitest'

// Dee, 2026-11-06: checkable rules belong in code. Phase 4's facts/access-only ban is superseded;
// rule refusals may use their plain names. Only the retired custom role registry must stay gone.
const REMOVED = {
  ROLE_KIND: 'Roles are free-text names; the removed registry must not impose a fixed kind enum.',
  ROLE_UNAVAILABLE: 'A role name does not need an entry in the removed custom role registry.',
  ROLE_IN_USE: 'There is no custom role record whose deletion must wait for agents using it.',
  ROLE_GONE: 'A start must not depend on a custom role record surviving in the retired registry.',
}

const SRC = join(fileURLToPath(new URL('.', import.meta.url)), '..')

const quoted = (code: string) => new RegExp(`['"\`]${code}['"\`]`)

function removedRefusals(text: string): string[] {
  return Object.keys(REMOVED).filter(code => quoted(code).test(text))
}

/** Every TypeScript source file under backend/src, tests left out. */
function sources(dir: string): string[] {
  return readdirSync(dir).flatMap(name => {
    const path = join(dir, name)
    if (statSync(path).isDirectory()) return sources(path)
    return name.endsWith('.ts') && !name.endsWith('.test.ts') ? [path] : []
  })
}

describe('retired role-registry refusals', () => {
  it.each(['\'', '"', '`'])('allows plain rule refusal codes in %s quotes', quote => {
    const codes = ['WORKER_DECISION_REQUIRED', 'LEAD_REQUIRED', 'REVIEW_OPEN', 'REVIEW_PENDING', 'REVIEW_TARGET',
      'CHECKS_PENDING', 'BRIEF_REQUIRED', 'INDEPENDENT_REVIEW', 'REVIEWER_NOT_ASSIGNABLE', 'REVIEW_GROUP',
      'REVIEWER_NOT_LEAD', 'ROLE_LEAD', 'ROLE_NAME', 'OVERRIDE_REASON_REQUIRED', 'ROUTE_REQUIRED', 'RULE_BROKEN',
      'REQUIREMENT_UNMET', 'REVIEW_REFUSED', 'STEPPED_UP', 'BUILD_REFUSED', 'MERGE_RECORDER', 'TELL_FORBIDDEN',
      'DECISION_FORBIDDEN', 'MENTION_FORBIDDEN', 'OWNER_MESSAGE_REQUIRED', 'WORK_REQUIRED', 'REVIEW_SHIPS_NOTHING']
    expect(removedRefusals(codes.map(code => `throw new Error(${quote}${code}${quote})`).join('\n'))).toEqual([])
  })

  it.each(['ROLE_KIND', 'ROLE_UNAVAILABLE', 'ROLE_IN_USE', 'ROLE_GONE'])('still detects the retired registry code %s', code => {
    for (const quote of ['\'', '"', '`']) {
      expect(removedRefusals(`throw new Error(${quote}${code}${quote})`)).toEqual([code])
    }
  })

  it('keeps a reason for each banned code', () => {
    for (const reason of Object.values(REMOVED)) expect(reason.trim()).not.toBe('')
  })

  it('reaches none of the retired registry refusals', () => {
    const files = sources(SRC)
    // The walk itself is checked: it reads the command handlers, where these codes were thrown.
    expect(files.map(f => relative(SRC, f))).toEqual(expect.arrayContaining(['superTabs/commands.ts', 'superTabs/store.ts', 'routes/superTabs.ts']))
    const found = files.flatMap(file => {
      const text = readFileSync(file, 'utf8')
      return removedRefusals(text).map(code => `${code} in ${relative(SRC, file)}`)
    })
    expect(found).toEqual([])
    // The same search finds refusals that stay: settings and who coordinates stay the coordinator's or a person's.
    const commands = readFileSync(join(SRC, 'superTabs/commands.ts'), 'utf8')
    expect(['COORDINATOR_REQUIRED', 'LEAD_PROTECTED'].every(code => quoted(code).test(commands))).toBe(true)
  })
})