@svp-labs/talos 0.0.0 → 0.1.0

package/dist/adopt/plan.js

@@ -0,0 +1,114 @@
+import { posix } from 'node:path';
+import { checkPrefix, parsed, resolveConfig } from './config.js';
+import { isFixture } from './dependabot.js';
+import { startDraft } from './draft.js';
+import { prePushHook } from './hooks.js';
+import { kitFiles } from './kit.js';
+import { languageSteps } from './languages.js';
+import { fromScaffold, scaffoldLeftovers } from './scaffold.js';
+import { securityMigration } from './security.js';
+import { withAdditions } from './talos-yml.js';
+import { briefPath } from './texts.js';
+import { tsconfigSteps } from './tsconfig.js';
+import { GITLEAKS_PROJECT } from '../checks/security/gitleaks-config.js';
+import { renderConfigs } from '../configs/files.js';
+import { repoFacts } from '../repo/facts.js';
+/**
+ * `talos.yml`, with what the repository's own scanner settings held. The security settings are
+ * read from the tree as it was, before any generated file takes their place, and never from
+ * excluded code or test fixtures.
+ */
+function settle(draft, input, seeds) {
+    const resolved = resolveConfig({ ...input, files: draft.files(), read: draft.read });
+    const own = repoFacts(input.files, resolved.config.exclude).files.filter((f) => !isFixture(f));
+    const security = securityMigration(own, input.read);
+    const current = resolved.text ?? draft.read('talos.yml') ?? '';
+    const text = withAdditions(current, security.additions);
+    if (resolved.text !== undefined || text !== current)
+        draft.write('talos.yml', text, 'talos.yml');
+    for (const file of security.moved)
+        draft.remove(file, 'migrated');
+    for (const step of security.next)
+        draft.next(step);
+    const gitleaks = security.gitleaks;
+    const project = draft.read(GITLEAKS_PROJECT);
+    if (gitleaks !== undefined && project !== undefined) {
+        draft.write(GITLEAKS_PROJECT, gitleaks(project), 'migration');
+    }
+    else if (gitleaks !== undefined) {
+        seeds.set(GITLEAKS_PROJECT, gitleaks);
+    }
+    return { config: parsed(text), status: resolved.status };
+}
+/**
+ * Every generated base through the shared rendering, and each missing extension file once: from
+ * its initial text, or the project's own settings moved into it. Returns the bases' paths.
+ */
+function generated(draft, input, config, seeds) {
+    const ctx = {
+        facts: repoFacts(draft.files(), config.exclude),
+        config,
+        side: 'alone',
+        tiers: ['commit', 'head'],
+    };
+    const rendered = renderConfigs(input.packs, ctx, input.version);
+    for (const file of rendered) {
+        const extension = file.extension;
+        const missing = extension !== undefined && !draft.has(extension.path);
+        draft.write(file.path, file.content, 'generated');
+        if (extension === undefined || !missing)
+            continue;
+        const seed = seeds.get(extension.path);
+        draft.write(extension.path, seed === undefined ? extension.content : seed(extension.content), 'extension');
+    }
+    return rendered.map((file) => file.path);
+}
+function brief(draft, input, config) {
+    if (input.brief === undefined)
+        return undefined;
+    const path = briefPath(config.docs.briefs, input.brief.fileName, input.brief.text, input.now);
+    const text = input.brief.text;
+    draft.write(path, text.endsWith('\n') ? text : `${text}\n`, 'brief');
+    return path;
+}
+/**
+ * Everything adoption writes and deletes in the working tree, and what must follow. Pure: it
+ * reads the tree only through `input.read`, and running it twice plans nothing the second time.
+ * It refuses a prefix another repository of the organisation uses, when it was given them.
+ */
+export function adoptPlan(input) {
+    const draft = startDraft(input.files, input.read);
+    for (const path of scaffoldLeftovers(input.files, input.read))
+        draft.remove(path, 'scaffold');
+    const scaffold = fromScaffold(input.files, input.read);
+    const seeds = new Map();
+    const { config, status } = settle(draft, input, seeds);
+    checkPrefix(input.prefixesInUse, input.repo, config.prefix);
+    kitFiles(draft, config, input.assets, scaffold);
+    for (const [path, seed] of languageSteps(draft, config, input.packs, input.assets)) {
+        seeds.set(path, seed);
+    }
+    const briefFile = brief(draft, input, config);
+    prePushHook(draft, input.assets);
+    const bases = generated(draft, input, config, seeds);
+    tsconfigSteps(draft, config, bases);
+    const done = draft.done();
+    return {
+        config,
+        talosYml: status,
+        brief: briefFile,
+        scaffold,
+        write: done.write,
+        delete: done.delete,
+        next: done.next,
+    };
+}
+/** The paths a plan touches, for staging exactly them and nothing else. */
+export function touchedPaths(plan) {
+    return [...plan.write.map((f) => f.path), ...plan.delete.map((d) => d.path)].map((p) => posix.normalize(p));
+}
+/** The files a plan writes that git must record as executable. */
+export function executablePaths(plan) {
+    return plan.write.filter((f) => f.mode === 'executable').map((f) => posix.normalize(f.path));
+}
+//# sourceMappingURL=plan.js.map

package/dist/adopt/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/adopt/plan.ts"],"names":[],"mappings":"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"}

package/dist/adopt/python.js

@@ -0,0 +1,200 @@
+import { prettyJson } from './json-text.js';
+import { eolOf, insertLines, joinToml, keyLine, parsedToml, replaceLine, sameToml, splitToml, within, } from './toml-text.js';
+import { durationHours } from '../checks/supply/settings.js';
+const isTable = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * In a file that extends the base, these would replace the base's lists instead of adding to
+ * them: its rule selection, its test-file ignores and ruff's default excludes.
+ */
+const RUFF_RENAMES = {
+    select: 'extend-select',
+    'lint.select': 'lint.extend-select',
+    'per-file-ignores': 'extend-per-file-ignores',
+    'lint.per-file-ignores': 'lint.extend-per-file-ignores',
+    exclude: 'extend-exclude',
+};
+function renamedRuff(settings) {
+    const out = {};
+    for (const [key, value] of Object.entries(settings)) {
+        if (key === 'lint' && isTable(value)) {
+            const lint = {};
+            for (const [inner, v] of Object.entries(value)) {
+                lint[(RUFF_RENAMES[`lint.${inner}`] ?? `lint.${inner}`).slice(5)] = v;
+            }
+            out.lint = lint;
+        }
+        else {
+            out[RUFF_RENAMES[key] ?? key] = value;
+        }
+    }
+    return out;
+}
+const KEY = /^(\s*)([\w.-]+)(\s*=)/;
+/** One `[tool.ruff…]` section as it reads in `ruff.toml`. */
+function ruffSection(section) {
+    const rel = (section.name ?? '').slice('tool.ruff'.length).replace(/^\./, '');
+    const lines = section.lines.map((line, index) => {
+        if (!section.top[index])
+            return line;
+        if (/^\s*\[/.test(line)) {
+            const name = RUFF_RENAMES[rel] ?? rel;
+            return rel === '' ? '' : `[${name}]`;
+        }
+        return line.replace(KEY, (whole, space, key, eq) => {
+            const full = rel === '' ? key : `${rel}.${key}`;
+            const renamed = RUFF_RENAMES[full];
+            return renamed === undefined
+                ? whole
+                : `${space}${renamed.slice(full.length - key.length)}${eq}`;
+        });
+    });
+    const header = section.lines.findIndex((line, i) => section.top[i] && /^\s*\[/.test(line));
+    return {
+        ...section,
+        lines: rel === '' ? lines.filter((_, i) => i !== header) : lines,
+        top: rel === '' ? section.top.filter((_, i) => i !== header) : section.top,
+    };
+}
+/** `ruff.toml`'s text after the base's `extend`, or why the settings can't move as text. */
+function ruffFragment(sections, settings) {
+    if (sections.some((s) => s.array))
+        return undefined;
+    const moved = sections.map(ruffSection);
+    const root = moved.filter((s) => s.name === 'tool.ruff');
+    const rest = moved.filter((s) => s.name !== 'tool.ruff');
+    const fragment = joinToml([...root, ...rest]);
+    const parsed = parsedToml(fragment);
+    return parsed !== undefined && sameToml(parsed, renamedRuff(settings)) ? fragment : undefined;
+}
+function pyrightSeed(settings) {
+    if ('extends' in settings)
+        return undefined;
+    return (initial) => {
+        const lines = initial.split('\n');
+        const comments = lines.filter((line) => line.startsWith('//'));
+        const json = JSON.parse(lines.filter((line) => !line.startsWith('//')).join('\n'));
+        const merged = { ...(isTable(json) ? json : {}), ...settings };
+        return `${[...comments, ''].join('\n')}${prettyJson(merged)}`;
+    };
+}
+function toolOf(parsed) {
+    return isTable(parsed.tool) ? parsed.tool : {};
+}
+function without(parsed, tools) {
+    const tool = Object.fromEntries(Object.entries(toolOf(parsed)).filter(([name]) => !tools.includes(name)));
+    const { tool: _, ...rest } = parsed;
+    return Object.keys(tool).length === 0 ? rest : { ...rest, tool };
+}
+/** basedpyright reads `[tool.basedpyright]` over `[tool.pyright]`. */
+function pyrightSettings(tool) {
+    const names = ['pyright', 'basedpyright'].filter((name) => isTable(tool[name]));
+    if (names.length === 0)
+        return undefined;
+    const settings = {};
+    for (const name of names) {
+        const table = tool[name];
+        if (isTable(table))
+            Object.assign(settings, table);
+    }
+    return { names, settings };
+}
+/** Which tables move and which go, by the tools they configure. */
+function plannedMoves(parsed, has) {
+    const tool = toolOf(parsed);
+    const ruff = !has.ruff && isTable(tool.ruff) ? tool.ruff : undefined;
+    const pyright = has.pyright ? undefined : pyrightSettings(tool);
+    return {
+        ...(ruff === undefined ? {} : { ruff }),
+        ...(pyright === undefined ? {} : { pyright: pyright.settings }),
+        gone: [
+            ...('mypy' in tool ? ['mypy'] : []),
+            ...(ruff === undefined ? [] : ['ruff']),
+            ...(pyright?.names ?? []),
+        ],
+    };
+}
+/**
+ * The migration of one `pyproject.toml`. `has` says which extension files the component has
+ * already: the tools read those, so the tables they shadow stay as they are.
+ */
+export function migratePyproject(text, has) {
+    const parsed = parsedToml(text);
+    if (parsed === undefined)
+        return { seeds: new Map(), manual: 'pyproject.toml is not valid TOML' };
+    const moves = plannedMoves(parsed, has);
+    if (moves.gone.length === 0)
+        return { seeds: new Map() };
+    const sections = splitToml(text);
+    const seeds = new Map();
+    if (moves.ruff !== undefined) {
+        if ('extend' in moves.ruff)
+            return { seeds, manual: 'its [tool.ruff] extends another file' };
+        const fragment = ruffFragment(sections.filter((s) => within(s.name, 'tool.ruff')), moves.ruff);
+        if (fragment === undefined)
+            return { seeds, manual: 'its [tool.ruff] is laid out unusually' };
+        seeds.set('ruff.toml', (initial) => `${initial}\n${fragment}`);
+    }
+    if (moves.pyright !== undefined) {
+        const seed = pyrightSeed(moves.pyright);
+        if (seed === undefined) {
+            return { seeds: new Map(), manual: 'its pyright settings extend a file' };
+        }
+        seeds.set('pyrightconfig.json', seed);
+    }
+    const kept = sections.filter((s) => !moves.gone.some((tool) => within(s.name, `tool.${tool}`)));
+    const next = joinToml(kept, eolOf(text));
+    const reparsed = parsedToml(next);
+    if (reparsed === undefined || !sameToml(reparsed, without(parsed, moves.gone))) {
+        return { seeds: new Map(), manual: 'its [tool] tables are laid out unusually' };
+    }
+    return { text: next, seeds };
+}
+/** A relative `exclude-newer` of a day or more: `1 day`, `2 weeks`, `24 hours` or `P1D`. */
+export function holdsADay(value) {
+    if (typeof value !== 'string')
+        return false;
+    const friendly = /^(\d+)\s*(hours?|days?|weeks?)$/i.exec(value.trim());
+    if (friendly === null)
+        return (durationHours(value.trim().toUpperCase()) ?? 0) >= 24;
+    const unit = (friendly[2] ?? '').toLowerCase().replace(/s$/, '');
+    const hours = Number(friendly[1]) * ({ hour: 1, day: 24, week: 168 }[unit] ?? 0);
+    return hours >= 24;
+}
+const UV_LINE = 'exclude-newer = "1 day"';
+function withUvLine(sections) {
+    const index = sections.findIndex((s) => s.name === 'tool.uv' && !s.array);
+    const section = sections[index];
+    if (section === undefined) {
+        const last = sections.at(-1)?.lines.at(-1);
+        const lines = [...(last === undefined || last.trim() === '' ? [] : ['']), '[tool.uv]', UV_LINE];
+        return [...sections, { name: 'tool.uv', array: false, lines, top: lines.map(() => true) }];
+    }
+    const at = keyLine(section, 'exclude-newer');
+    if (at !== -1)
+        return sections.map((s, i) => (i === index ? replaceLine(s, at, UV_LINE) : s));
+    const header = section.lines.findIndex((line, i) => section.top[i] && /^\s*\[/.test(line));
+    return sections.map((s, i) => (i === index ? insertLines(s, header + 1, [UV_LINE]) : s));
+}
+/**
+ * `[tool.uv] exclude-newer = "1 day"`, so uv resolves only releases at least a day old and
+ * records the span in `uv.lock`. A span of a day or more stays as it is.
+ */
+export function holdUvADay(text) {
+    const parsed = parsedToml(text);
+    if (parsed === undefined)
+        return { manual: 'pyproject.toml is not valid TOML' };
+    const uv = toolOf(parsed).uv;
+    if (isTable(uv) && holdsADay(uv['exclude-newer']))
+        return {};
+    const next = joinToml(withUvLine(splitToml(text)), eolOf(text));
+    const tool = toolOf(parsed);
+    const wanted = {
+        ...parsed,
+        tool: { ...tool, uv: { ...(isTable(uv) ? uv : {}), 'exclude-newer': '1 day' } },
+    };
+    const reparsed = parsedToml(next);
+    return reparsed !== undefined && sameToml(reparsed, wanted)
+        ? { text: next }
+        : { manual: 'its [tool.uv] could not be edited safely' };
+}
+//# sourceMappingURL=python.js.map

package/dist/adopt/python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.js","sourceRoot":"","sources":["../../src/adopt/python.ts"],"names":[],"mappings":"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"}

package/dist/adopt/remote.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { AdoptRefusal } from './config.js';
+import { ADOPT_MARKER, bootstrapIssueBody, bootstrapPullBody, bootstrapSubject, bootstrapTitle, } from './texts.js';
+import { GitHubError } from '../github/api.js';
+import { sameLogin } from '../github/identities.js';
+import { shippedLabels, syncLabels } from '../jobs/label-sync.js';
+import { branchFor, claimantOf, claimLine } from '../ticket/claim.js';
+import { addComment, addLabels, branchHead, defaultBranch, listComments, openPullsFrom, refSha, } from '../ticket/github.js';
+import { LABEL } from '../ticket/labels.js';
+import { parseIssue, parseIssues } from '../ticket/schemas.js';
+import { carriesApproval } from '../ticket/trust.js';
+/**
+ * Adoption's effects on GitHub, all within what Thea's App may do (issues and contents): the
+ * labels, `legacy` on the old backlog, the bootstrap issue and its claim, and the bootstrap PR.
+ */
+const CLAIMED = [LABEL.chore, LABEL.inProgress, LABEL.claimed];
+/** The bootstrap issue of an earlier run, filed by the owner or Thea; anyone can type a marker. */
+export function findBootstrap(issues, who) {
+    return issues.find((issue) => !issue.isPull &&
+        issue.body.includes(ADOPT_MARKER) &&
+        (sameLogin(issue.author, who.owner) || sameLogin(issue.author, who.thea)));
+}
+/** The open issues that become `legacy`: every one but the bootstrap issue, once. */
+export function legacyTargets(issues, bootstrap) {
+    return issues
+        .filter((i) => !i.isPull && i.number !== bootstrap && !i.labels.includes(LABEL.legacy))
+        .map((i) => i.number);
+}
+function refuseApproval(...texts) {
+    if (texts.some(carriesApproval)) {
+        throw new AdoptRefusal('text Talos writes to GitHub may not contain talos-approve');
+    }
+}
+async function fileBootstrap(gh, repo, text) {
+    const title = bootstrapTitle(text.name);
+    const body = bootstrapIssueBody(text);
+    refuseApproval(title, body);
+    const created = await gh.request('POST', `repos/${repo}/issues`, {
+        body: { title, body, labels: CLAIMED },
+    });
+    return parseIssue(created);
+}
+/** The claim's lock: the ticket branch at the default branch's head, unless it exists. */
+async function lockBranch(gh, repo, branch) {
+    if ((await branchHead(gh, repo, branch)) !== undefined)
+        return;
+    const sha = await refSha(gh, repo, await defaultBranch(gh, repo));
+    await gh.request('POST', `repos/${repo}/git/refs`, {
+        body: { ref: `refs/heads/${branch}`, sha },
+    });
+}
+/**
+ * Labels the repository, marks the old backlog `legacy`, then files (or finds) the bootstrap
+ * issue and claims it. The old issues are marked first, so the bootstrap issue never is.
+ */
+export async function startAdoption(gh, repo, who, options) {
+    const labels = await syncLabels(gh, repo, await shippedLabels());
+    const open = parseIssues(await gh.paginate(`repos/${repo}/issues?state=open`));
+    const found = findBootstrap(open, who);
+    const legacy = legacyTargets(open, found?.number);
+    for (const n of legacy)
+        await addLabels(gh, repo, n, [LABEL.legacy]);
+    const issue = found ?? (await fileBootstrap(gh, repo, options));
+    const missing = CLAIMED.filter((label) => !issue.labels.includes(label));
+    if (found !== undefined)
+        await addLabels(gh, repo, issue.number, missing);
+    const branch = branchFor(options.prefix, issue.number);
+    await lockBranch(gh, repo, branch);
+    if (claimantOf(await listComments(gh, repo, issue.number), who) === undefined) {
+        const line = claimLine(options.agent, options.now);
+        refuseApproval(line);
+        await addComment(gh, repo, issue.number, line);
+    }
+    return { issue: issue.number, branch, filed: found === undefined, labels, legacy: legacy.length };
+}
+const compareSchema = z.object({
+    ahead_by: z.number().int(),
+    files: z.array(z.unknown()).default([]),
+});
+const pullSchema = z.object({ number: z.number().int(), html_url: z.string() });
+/** Opens the bootstrap PR from the pushed ticket branch, ready for the owner's review. */
+export async function openBootstrapPull(gh, repo, options) {
+    const branch = branchFor(options.prefix, options.issue);
+    const [existing] = await openPullsFrom(gh, repo, branch);
+    if (existing !== undefined)
+        return { pr: existing.number, opened: false };
+    const base = await defaultBranch(gh, repo);
+    let compared;
+    try {
+        const raw = await gh.request('GET', `repos/${repo}/compare/${base}...${branch}`);
+        compared = compareSchema.parse(raw);
+    }
+    catch (error) {
+        if (error instanceof GitHubError && error.status === 404)
+            compared = { ahead_by: 0, files: [] };
+        else
+            throw error;
+    }
+    if (compared.ahead_by === 0) {
+        throw new AdoptRefusal(`${branch} has no commits beyond ${base}: push the adoption first`);
+    }
+    const title = bootstrapSubject(options.prefix, options.issue, options.name);
+    const body = bootstrapPullBody({ ...options, changed: compared.files.length });
+    refuseApproval(title, body);
+    const created = await gh.request('POST', `repos/${repo}/pulls`, {
+        body: { title, head: branch, base, body, draft: false },
+    });
+    return { pr: pullSchema.parse(created).number, opened: true };
+}
+//# sourceMappingURL=remote.js.map

package/dist/adopt/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/adopt/remote.ts"],"names":[],"mappings":"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"}