Janady13/thatstupidcomputer / scripts/apply-room-tab-cleanup.mjs

1#!/usr/bin/env node 2/** One AST-selected JSX deletion; never replace the edited live Workshop file. */ 3import { parseSync } from 'rolldown/utils'; 4import { createHash, randomUUID } from 'node:crypto'; 5import { lstatSync, readFileSync, mkdirSync, openSync, writeFileSync, closeSync, fsyncSync, renameSync, unlinkSync } from 'node:fs'; 6import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path'; 7import { fileURLToPath } from 'node:url'; 8 9const FILE = 'apps/web/src/components/Workshop.tsx'; 10const hash = bytes => createHash('sha256').update(bytes).digest('hex'); 11const stat = path => { try { return lstatSync(path); } catch (error) { if (error.code === 'ENOENT') return null; throw error; } }; 12 13function parse(source) { 14 const result = parseSync('Workshop.tsx', source, { lang: 'tsx' }); 15 if (result.errors.length) throw new Error('Workshop.tsx contains parse errors; review the file before cleanup'); 16 return result.program; 17} 18 19/** Returns an exact byte-preserving edit range (UTF-16 string offsets). No AST 20 * printer, formatting, import cleanup, symbol execution or layout rewrite. */ 21export function removeRoomNavigation(source) { 22 if (typeof source !== 'string') throw new TypeError('Expected TSX source text'); 23 const file = parse(source), matches = []; 24 let ambiguous = false; 25 function visit(node, parent) { 26 if (!node || typeof node !== 'object') return; 27 if (node.type === 'JSXElement') { 28 const opening = node.openingElement; 29 if (opening.name.type === 'JSXIdentifier' && opening.name.name === 'nav') { 30 const attributes = opening.attributes; 31 const classes = attributes.filter(attribute => attribute.type === 'JSXAttribute' && attribute.name.name === 'className'); 32 let matching = false; 33 for (const attribute of classes) { 34 let value = attribute.value; 35 if (value?.type === 'JSXExpressionContainer') value = value.expression; 36 const literal = value?.type === 'Literal' && typeof value.value === 'string' ? value.value 37 : value?.type === 'TemplateLiteral' && value.expressions.length === 0 ? value.quasis[0].value.cooked : null; 38 if (typeof literal === 'string') { 39 if (literal.split(/\s+/).includes('room-navigation')) matching = true; 40 } else if (source.slice(attribute.start, attribute.end).includes('room-navigation')) ambiguous = true; 41 } 42 if (matching) { 43 // A spread or duplicate may override the apparent class at runtime. 44 if (classes.length !== 1 || attributes.some(attribute => attribute.type === 'JSXSpreadAttribute')) ambiguous = true; 45 matches.push({ node, parent }); 46 } 47 } 48 } 49 for (const value of Object.values(node)) { 50 if (Array.isArray(value)) for (const child of value) visit(child, node); 51 else if (value && typeof value === 'object') visit(value, node); 52 } 53 } 54 visit(file); 55 if (ambiguous || matches.length > 1) throw new Error('Ambiguous room-navigation markup; manual review required'); 56 if (matches.length === 0) { 57 if (source.includes('room-navigation')) throw new Error('Room-navigation marker exists outside a supported literal nav; manual review required'); 58 return { status: 'already-clean', source, edit: null }; 59 } 60 const { node, parent } = matches[0], { start, end } = node; 61 const replacement = parent?.type === 'JSXElement' || parent?.type === 'JSXFragment' ? '' : 'null'; 62 const cleaned = source.slice(0, start) + replacement + source.slice(end); 63 parse(cleaned); 64 return { status: 'ready', source: cleaned, edit: { start, end, replacement, removedCharacters: end - start } }; 65} 66 67function safePath(path, { directory = false, optional = false } = {}) { 68 const absolute = resolve(path); 69 let current = absolute.startsWith(sep) ? sep : absolute.slice(0, 3); 70 const parts = relative(current, absolute).split(sep).filter(Boolean); 71 for (let index = 0; index < parts.length; index++) { 72 current = join(current, parts[index]); const info = stat(current); 73 if (!info) { if (optional) return null; throw new Error(`Missing path: ${current}`); } 74 if (info.isSymbolicLink()) throw new Error(`Symlink traversal rejected: ${current}`); 75 const expectsDirectory = index < parts.length - 1 || directory; 76 if (expectsDirectory ? !info.isDirectory() : !info.isFile()) throw new Error(`Unexpected file type: ${current}`); 77 } 78 return stat(absolute); 79} 80 81function atomicWrite(path, bytes, mode) { 82 const temporary = join(dirname(path), `.room-tab-cleanup-${randomUUID()}.tmp`); 83 let fd; 84 try { 85 fd = openSync(temporary, 'wx', mode); writeFileSync(fd, bytes); fsyncSync(fd); closeSync(fd); fd = undefined; 86 renameSync(temporary, path); 87 } finally { 88 if (fd !== undefined) closeSync(fd); 89 try { unlinkSync(temporary); } catch (error) { if (error.code !== 'ENOENT') throw error; } 90 } 91} 92 93/** beforeCommit is a test-only in-process seam; no CLI hook is accepted. */ 94export function cleanupWorkshop({ targetRoot, apply = false, beforeCommit }) { 95 if (typeof targetRoot !== 'string' || !isAbsolute(targetRoot)) throw new Error('--target must be an absolute project directory'); 96 targetRoot = resolve(targetRoot); safePath(targetRoot, { directory: true }); 97 const packagePath = join(targetRoot, 'package.json'); safePath(packagePath); 98 if (JSON.parse(readFileSync(packagePath, 'utf8')).name !== 'thatstupidcomputer') throw new Error('Wrong target package.name'); 99 const path = join(targetRoot, FILE), info = safePath(path); 100 const before = readFileSync(path), source = before.toString('utf8'); 101 if (!Buffer.from(source, 'utf8').equals(before)) throw new Error('Workshop.tsx must be valid UTF-8'); 102 const result = removeRoomNavigation(source), after = Buffer.from(result.source, 'utf8'); 103 const report = { schema: 'tsc-room-tab-cleanup/v4', status: result.status, mode: apply ? 'apply' : 'dry-run', targetRoot, file: FILE, beforeSha256: hash(before), afterSha256: hash(after), edit: result.edit }; 104 if (!apply || result.status === 'already-clean') return report; 105 const backupBase = join(targetRoot, '.room-tab-cleanup-backups'); 106 safePath(backupBase, { directory: true, optional: true }); 107 beforeCommit?.(); 108 safePath(path); 109 if (hash(readFileSync(path)) !== report.beforeSha256) throw new Error('Workshop.tsx changed after preflight; no file was replaced'); 110 safePath(backupBase, { directory: true, optional: true }); 111 if (!stat(backupBase)) mkdirSync(backupBase, { mode: 0o700 }); 112 const backupRoot = join(backupBase, randomUUID()); mkdirSync(backupRoot, { mode: 0o700 }); 113 const backupPath = join(backupRoot, 'Workshop.tsx'); writeFileSync(backupPath, before, { flag: 'wx', mode: 0o600 }); 114 const journalPath = join(backupRoot, 'restoration.json'); 115 const journal = { ...report, status: 'prepared', originalMode: info.mode & 0o777, backup: 'Workshop.tsx' }; 116 writeFileSync(journalPath, `${JSON.stringify(journal, null, 2)}\n`, { flag: 'wx', mode: 0o600 }); 117 let committed = false; 118 try { 119 safePath(path); 120 if (hash(readFileSync(path)) !== report.beforeSha256) throw new Error('Workshop.tsx changed while the backup was prepared'); 121 atomicWrite(path, after, info.mode & 0o777); committed = true; 122 atomicWrite(journalPath, `${JSON.stringify({ ...journal, status: 'applied' }, null, 2)}\n`, 0o600); 123 return { ...report, status: 'applied', backupRoot }; 124 } catch (error) { 125 let status = 'not-applied'; 126 if (committed) { 127 try { 128 safePath(path); 129 if (hash(readFileSync(path)) !== report.afterSha256) throw new Error('Later edit detected'); 130 atomicWrite(path, before, info.mode & 0o777); status = 'rolled-back'; 131 } catch { status = 'manual-restoration-required'; } 132 } 133 try { atomicWrite(journalPath, `${JSON.stringify({ ...journal, status, error: error.message }, null, 2)}\n`, 0o600); } catch { /* The original backup remains readable. */ } 134 throw new Error(`${error.message}; ${status}. Original backup: ${backupPath}`); 135 } 136} 137 138function main(args) { 139 let targetRoot, apply = false; 140 for (let index = 0; index < args.length; index++) { 141 if (args[index] === '--target' && targetRoot === undefined && args[index + 1] && !args[index + 1].startsWith('--')) targetRoot = args[++index]; 142 else if (args[index] === '--apply' && !apply) apply = true; 143 else throw new Error('Usage: node scripts/apply-room-tab-cleanup.mjs --target ABSROOT [--apply]'); 144 } 145 process.stdout.write(`${JSON.stringify(cleanupWorkshop({ targetRoot, apply }), null, 2)}\n`); 146} 147if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) { 148 try { main(process.argv.slice(2)); } catch (error) { process.stderr.write(`${JSON.stringify({ status: 'blocked', error: error.message })}\n`); process.exitCode = 1; } 149} 150