Redesign an existing website to make it better. Built on top of impeccable.
88%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
#!/usr/bin/env node
/**
* rollout/seed-redirects.mjs — seed stardust/redirects.tsv from a spec's knowledge (stardust/spec/knowledge/), so the
* redirects sheet carries every source URL that changes on EDS before the path-safety gate adds its own rows.
*
* node seed-redirects.mjs [--knowledge stardust/spec/knowledge] [--out stardust/redirects.tsv]
* [--coverage stardust/rollout/coverage/pages.json] [--dry-run]
*
* Rows (source path → delivered URL, eds-path.mjs):
* migration every page whose delivered URL differs from its source path (`.html` dropped, segments sanitised)
* legacy a redirect the source serves today, when its target is a page of the knowledge: the source path → that
* page's delivered URL (one hop on EDS instead of two)
* Skipped and counted: external targets, targets that are not pages of the knowledge, loops. Rows already in the file
* win (the path-safety gate's and the owner's decisions); comments and order are kept; new rows are appended under
* one comment line. A source EDS never matches against the redirects sheet (a `:`, `%` or other character outside
* `A-Za-z0-9._~/-`: the request 404s first, measured on a live site) goes to <out dir>/redirects-cdn.tsv instead:
* a CDN rule's job. With rollout's coverage (default path, when present) a row is written only when its destination
* is a delivered page — a redirect into a page of a later wave would 404; re-run the seed after each wave.
* Exit 1 when the knowledge folder is missing.
*/
import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
import { dirname, join } from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';
import { pathKey } from './lib.mjs'; // the canonical lookup key (lib/paths.mjs, formerly reached through deploy's eds-path.mjs)
const argv = process.argv.slice(2);
const arg = (k, d) => { const i = argv.indexOf(`--${k}`); return i >= 0 && argv[i + 1] && !argv[i + 1].startsWith('--') ? argv[i + 1] : d; };
const pathOf = (u) => { try { return new URL(u).pathname; } catch { return String(u || ''); } };
/** A source path the EDS redirects sheet can match. Pure. */
export const sheetMatchable = (src) => !/[^A-Za-z0-9._~/-]/.test(src);
/**
* New [source, destination] rows from knowledge redirects and urls, minus sources already present (by lookup key).
* Returns { rows, cdn, counts }: `cdn` holds the rows whose source the sheet cannot match. Pure given the path functions.
*/
export function seedRows(redirects, urls, existingSources, { pathKey }, delivered = null) {
const have = new Set([...existingSources].map(pathKey));
const pageAt = new Map();
for (const u of urls) if (u.outcome === 'page' && u.eds_path) { pageAt.set(u.url, u.eds_path); if (u.final_url) pageAt.set(u.final_url, u.eds_path); }
const counts = { migration: 0, legacy: 0, present: 0, external: 0, 'not-a-page': 0, loop: 0, cdn: 0, 'later-wave': 0 };
const rows = []; const cdn = []; const seen = new Set();
const add = (src, dst, kind) => {
const k = pathKey(src);
if (have.has(k) || seen.has(k)) { counts.present += 1; return; }
if (delivered && !delivered.has(pathKey(dst))) { counts['later-wave'] += 1; return; }
if (src === dst) return;
seen.add(k);
if (!sheetMatchable(src)) { cdn.push([src, dst]); counts.cdn += 1; return; }
rows.push([src, dst]); counts[kind] += 1;
};
for (const r of redirects) {
if (r.kind === 'migration') add(r.src, r.target, 'migration');
else if (r.kind === 'legacy') {
if (!r.target) counts.loop += 1;
else if (r.external) counts.external += 1;
else if (!pageAt.has(r.target)) counts['not-a-page'] += 1;
else add(pathOf(r.src), pageAt.get(r.target), 'legacy');
}
}
return { rows, cdn, counts };
}
async function main() {
if (argv.includes('--help') || argv.includes('-h')) { process.stdout.write(`${readFileSync(fileURLToPath(import.meta.url), 'utf8').split('*/')[0].replace(/^#!.*\n\/\*\*\n?/, '').replace(/^ \* ?/gm, '')}\n`); return; }
const dir = arg('knowledge', join('stardust', 'spec', 'knowledge')); const out = arg('out', join('stardust', 'redirects.tsv'));
if (!existsSync(join(dir, 'redirects.jsonl'))) { console.error(`seed-redirects: ${join(dir, 'redirects.jsonl')} missing — no spec knowledge to seed from`); process.exit(1); }
const jl = (f) => (existsSync(join(dir, f)) ? readFileSync(join(dir, f), 'utf8').split('\n').filter(Boolean).map((l) => JSON.parse(l)) : []);
const existing = existsSync(out) ? readFileSync(out, 'utf8') : '';
const sources = existing.split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith('#')).map((l) => l.split(/\t+|\s{2,}/)[0]);
const coverage = arg('coverage', join('stardust', 'rollout', 'coverage', 'pages.json'));
// a delivered page by its delivered path, and by the knowledge row of its source URL (rollout records it)
let delivered = null;
if (existsSync(coverage)) {
const covered = JSON.parse(readFileSync(coverage, 'utf8')).pages; const sources = new Set(covered.map((pg) => pg.source && pg.source.sourceUrl).filter(Boolean));
delivered = new Set(covered.map((pg) => pathKey(pg.path || `/${pg.slug}`)));
jl('urls.jsonl').forEach((u) => { if (u.eds_path && (sources.has(u.url) || sources.has(u.final_url))) delivered.add(pathKey(u.eds_path)); });
}
const { rows, cdn, counts } = seedRows(jl('redirects.jsonl'), jl('urls.jsonl'), sources, { pathKey }, delivered);
const cdnOut = join(dirname(out), 'redirects-cdn.tsv');
const summary = `${rows.length} added (migration ${counts.migration}, legacy ${counts.legacy}); kept ${counts.present} already present or repeated; skipped external ${counts.external}, not-a-page ${counts['not-a-page']}, loop ${counts.loop}${delivered ? `, later wave ${counts['later-wave']}` : ''}${counts.cdn ? `; ${counts.cdn} the sheet cannot match → ${cdnOut} (a CDN rule)` : ''}`;
if (rows.length && !argv.includes('--dry-run')) {
mkdirSync(dirname(out), { recursive: true });
const head = existing && !existing.endsWith('\n') ? `${existing}\n` : existing;
writeFileSync(out, `${head}# seeded from ${dir}/redirects.jsonl (${new Date().toISOString().slice(0, 10)})\n${rows.map(([s, d]) => `${s}\t${d}`).join('\n')}\n`);
}
if (cdn.length && !argv.includes('--dry-run')) writeFileSync(cdnOut, `# sources the EDS redirects sheet never matches (they 404 first): configure them at the CDN\n${cdn.map(([s, d]) => `${s}\t${d}`).join('\n')}\n`);
console.log(`seed-redirects: ${summary}${argv.includes('--dry-run') ? ' [dry run]' : ` → ${out}`}`);
}
if (import.meta.url === pathToFileURL(process.argv[1] || '').href) main().catch((e) => { console.error(e.message); process.exit(1); });.tessl-plugin
skills
audit
reference
deploy
reference
scripts
test
diff
direct
dynamics
extract
migrate
prepare-migration
prototype
assets
motion
fixtures
reference
qa
replica
reference
scripts
test
reskin
rollout
spec
stardust
uplift
reference