/**
|
* Postcondition scanner for accepted/carbonized source. The carbonize
|
* contract used to exist only as prose in reference/live.md; nothing checked
|
* that an accept actually left the file clean, so dead param branches,
|
* preview attributes, and marker comments accumulated across sessions. This
|
* scanner is the mechanical form of that contract. live-complete refuses to
|
* mark a carbonize session complete while the file is dirty, and the
|
* mechanical Svelte accept runs it on its own output as a self-check.
|
*/
|
|
// Param patterns are anchored to the exact shapes live mode writes
|
// (attribute-with-value / selector forms, var() references), not bare
|
// substrings, so user tokens that merely share the prefix cannot trip the
|
// completion gate.
|
const FORBIDDEN = [
|
{ marker: 'impeccable-variants-start', why: 'variant wrapper comment left in source' },
|
{ marker: 'impeccable-variants-end', why: 'variant wrapper comment left in source' },
|
{ marker: 'impeccable-carbonize-start', why: 'carbonize block not rewritten into permanent form' },
|
{ marker: 'impeccable-carbonize-end', why: 'carbonize block not rewritten into permanent form' },
|
{ marker: 'impeccable-param-values', why: 'param-values comment not baked and removed' },
|
{ marker: 'data-impeccable-', why: 'live-mode plumbing attribute left on markup' },
|
{ marker: /\bdata-p-[A-Za-z0-9_-]+\s*(?:=|\])/, label: 'data-p-*', why: 'preview parameter attribute left on markup' },
|
{ marker: /var\(\s*--p-[A-Za-z0-9_-]+\s*[,)]/, label: 'var(--p-*)', why: 'preview parameter variable not baked to a literal' },
|
{ marker: '--impeccable-variant-ready', why: 'preview readiness sentinel left in CSS' },
|
];
|
|
/**
|
* Scan file text for live-mode leftovers. Returns { clean, findings } where
|
* each finding is { marker, line, excerpt, why }.
|
*/
|
export function verifyAcceptedSource(text) {
|
const findings = [];
|
const lines = String(text || '').split('\n');
|
for (let i = 0; i < lines.length; i++) {
|
const line = lines[i];
|
for (const { marker, label, why } of FORBIDDEN) {
|
const hit = marker instanceof RegExp ? marker.test(line) : line.includes(marker);
|
if (hit) {
|
findings.push({
|
marker: label || String(marker),
|
line: i + 1,
|
excerpt: line.trim().slice(0, 120),
|
why,
|
});
|
}
|
}
|
}
|
return { clean: findings.length === 0, findings };
|
}
|
|
/** Convenience wrapper for CLI callers: read + scan, tolerating a missing file. */
|
export function verifyAcceptedFile(fs, filePath) {
|
let text;
|
try {
|
text = fs.readFileSync(filePath, 'utf-8');
|
} catch {
|
return { clean: true, findings: [], missing: true };
|
}
|
return { ...verifyAcceptedSource(text), missing: false };
|
}
|
