tinybeeai 0.0.0-stage → 0.16.1

package/dist/review/golden-export.js

@@ -0,0 +1,219 @@
+// Golden export (KAT-210, docs/DOGFOOD-LEDGER.md "Refresh the decision set"): turns the approvals a person
+// decided in a dot's database into candidate eval cases under test/fixtures/qa-review/decisions/<id>/.
+//
+//   input.json     the draft (kind, target, title, body, the meta fields a report needs), the watch it was drafted
+//                  for (only what the safety rules read), and the facts of the run that made it
+//   expected.json  the human decision: approve or reject, and for a reject the escalation category
+//
+// The database is opened read-only. Every string is masked before it is written: email addresses, tokens, home
+// paths, and URLs outside github.com/duonghaijoe and linear.app/katalon-pm. Run the export, then read every file it
+// wrote before committing it.
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+export const DECISIONS_DIR_NAME = 'decisions';
+/** Report drafts (a PR comment, a check run) and defect drafts (a defect, an issue). */
+export const DECISION_KINDS = ['pr_comment', 'check_run', 'file_defect', 'issue_create'];
+/** `executed` is an approval that went out. */
+export const DECIDED = ['approved', 'executed', 'rejected'];
+const ALLOWED_URL = /^https?:\/\/(?:www\.)?(?:github\.com\/duonghaijoe(?:[/?#]|$)|linear\.app\/katalon-pm(?:[/?#]|$))/i;
+const URL_RE = /https?:\/\/[^\s)>\]"'`<]+/gi;
+const EMAIL_RE = /[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}/g;
+const TOKEN_RES = [
+    /\bgh[pousr]_[A-Za-z0-9]{20,}\b/g,
+    /\bgithub_pat_[A-Za-z0-9_]{20,}\b/g,
+    /\bsk-[A-Za-z0-9_-]{16,}\b/g,
+    /\bxox[abprs]-[A-Za-z0-9-]{10,}\b/g,
+    /\blin_(?:api|oauth)_[A-Za-z0-9]{16,}\b/g,
+    /\bAKIA[0-9A-Z]{16}\b/g,
+    /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{5,}\b/g,
+    /\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/g,
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?(?:-----END [A-Z ]*PRIVATE KEY-----|$)/g,
+];
+/** `token=abc`, `"apiKey": "abc"`, `password: abc`. The value goes, the name stays. */
+const ASSIGNED_SECRET_RE = /\b((?:[A-Za-z_]*(?:token|secret|password|passwd|api[_-]?key|private[_-]?key|authorization))["']?\s*[:=]\s*["']?)([^\s"',;)]{6,})/gi;
+const HOME_RE = /\/(?:Users|home)\/[A-Za-z0-9._-]+/g;
+/** One string, masked. */
+export function maskText(text) {
+    let t = text;
+    // Tokens first, so a token inside a URL does not leave half of itself behind.
+    for (const re of TOKEN_RES)
+        t = t.replace(re, '<token>');
+    t = t.replace(ASSIGNED_SECRET_RE, (_m, name) => `${name}<token>`);
+    t = t.replace(URL_RE, (u) => (ALLOWED_URL.test(u) ? u : '<url>'));
+    t = t.replace(EMAIL_RE, '<email>');
+    t = t.replace(HOME_RE, (m) => `${m.startsWith('/Users') ? '/Users' : '/home'}/<user>`);
+    return t;
+}
+/** Every string in a JSON value, masked; keys stay. */
+export function maskDeep(v) {
+    if (typeof v === 'string')
+        return maskText(v);
+    if (Array.isArray(v))
+        return v.map((x) => maskDeep(x));
+    if (v && typeof v === 'object')
+        return Object.fromEntries(Object.entries(v).map(([k, x]) => [k, maskDeep(x)]));
+    return v;
+}
+/** The meta fields a report or a defect draft needs; nothing else leaves the database. */
+const META_KEYS = [
+    'sticky',
+    'reportSummary',
+    'head',
+    'sha',
+    'conclusion',
+    'outcome',
+    'text',
+    'pr',
+    'bugKey',
+    'severity',
+    'tracker',
+    'project',
+    'projectName',
+    'bugs',
+    'risks',
+];
+const parse = (s) => {
+    if (typeof s !== 'string')
+        return s ?? undefined;
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+};
+const obj = (s) => {
+    const v = parse(s);
+    return v && typeof v === 'object' && !Array.isArray(v) ? v : {};
+};
+/** Builds one masked case from an approvals row, its watch and its run. Null when the row is not a decided report or defect draft. */
+export function buildDecisionCase(row, watch, run) {
+    const kind = String(row.action.kind ?? '');
+    if (!DECISION_KINDS.includes(kind))
+        return null;
+    if (!DECIDED.includes(row.status))
+        return null;
+    const decision = row.status === 'rejected' ? 'reject' : 'approve';
+    const escalation = (row.extra.escalation ?? {});
+    const meta = obj(row.action.meta);
+    const keptMeta = Object.fromEntries(META_KEYS.filter((k) => k in meta).map((k) => [k, meta[k]]));
+    const verdict = obj(run?.verdict);
+    const input = {
+        approval: {
+            id: row.id,
+            kind,
+            createdAt: row.createdAt,
+            ...(escalation.by ? { escalatedBy: escalation.by } : {}),
+            ...(row.reason ? { escalationReason: row.reason } : {}),
+        },
+        action: {
+            kind,
+            target: String(row.action.target ?? ''),
+            title: String(row.action.title ?? ''),
+            body: String(row.action.body ?? ''),
+            ...(Object.keys(keptMeta).length ? { meta: keptMeta } : {}),
+        },
+        watch: {
+            name: typeof watch.name === 'string' ? watch.name : undefined,
+            mustNot: typeof watch.mustNot === 'string' ? watch.mustNot : undefined,
+            repo: parse(watch.repo),
+            repos: parse(watch.repos),
+            tracker: stripTrackerUrl(parse(watch.tracker)),
+            slackChannel: typeof watch.slackChannel === 'string' ? watch.slackChannel : undefined,
+        },
+        ...(run
+            ? {
+                run: {
+                    id: String(run.id),
+                    kind: typeof run.kind === 'string' ? run.kind : undefined,
+                    status: typeof run.status === 'string' ? run.status : undefined,
+                    verdict: { outcome: verdict.outcome, headline: verdict.headline },
+                },
+            }
+            : {}),
+    };
+    const expected = {
+        decision,
+        ...(decision === 'reject' ? { category: escalation.category ?? 'other' } : {}),
+        kind,
+        decidedAt: row.decidedAt ?? row.createdAt,
+    };
+    // JSON round trip drops the undefined fields.
+    return { id: row.id, input: maskDeep(JSON.parse(JSON.stringify(input))), expected };
+}
+function stripTrackerUrl(t) {
+    if (t && typeof t === 'object' && !Array.isArray(t)) {
+        const { baseUrl: _baseUrl, ...rest } = t;
+        return rest;
+    }
+    return t;
+}
+/** Round-robin over the kind-and-decision groups, newest first inside each, so a small export holds approvals and rejections of every kind. */
+export function spread(cases, limit) {
+    if (!limit || limit >= cases.length)
+        return cases;
+    const groups = new Map();
+    for (const c of [...cases].sort((a, b) => b.expected.decidedAt.localeCompare(a.expected.decidedAt))) {
+        const key = `${c.expected.kind}:${c.expected.decision}`;
+        groups.set(key, [...(groups.get(key) ?? []), c]);
+    }
+    const lists = [...groups.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([, v]) => v);
+    const out = [];
+    for (let i = 0; out.length < limit && lists.some((l) => i < l.length); i++)
+        for (const l of lists)
+            if (i < l.length && out.length < limit)
+                out.push(l[i]);
+    return out;
+}
+/** Reads the decided drafts decided on or after `since` and writes one folder per case. */
+export function exportDecisions(o) {
+    if (!existsSync(o.db))
+        throw new Error(`database not found: ${o.db}`);
+    const db = new DatabaseSync(o.db, { readOnly: true });
+    try {
+        const kinds = DECISION_KINDS.map(() => '?').join(',');
+        const states = DECIDED.map(() => '?').join(',');
+        const rows = db
+            .prepare(`SELECT id, createdAt, decidedAt, status, action, reason, extra, watchId, runId FROM approvals
+         WHERE status IN (${states}) AND json_extract(action, '$.kind') IN (${kinds}) AND COALESCE(decidedAt, createdAt) >= ?
+         ORDER BY COALESCE(decidedAt, createdAt)`)
+            .all(...DECIDED, ...DECISION_KINDS, o.since);
+        const watchStmt = db.prepare('SELECT * FROM watches WHERE id = ?');
+        const runStmt = db.prepare('SELECT id, kind, status, verdict FROM runs WHERE id = ?');
+        const cases = [];
+        for (const r of rows) {
+            const row = {
+                id: String(r.id),
+                createdAt: String(r.createdAt),
+                decidedAt: r.decidedAt,
+                status: String(r.status),
+                action: obj(r.action),
+                reason: r.reason,
+                extra: obj(r.extra),
+                watchId: r.watchId,
+                runId: r.runId,
+            };
+            const watch = (row.watchId ? watchStmt.get(row.watchId) : undefined) ?? {};
+            const run = row.runId ? runStmt.get(row.runId) : undefined;
+            const c = buildDecisionCase(row, watch, run);
+            if (c)
+                cases.push(c);
+        }
+        const chosen = spread(cases, o.limit);
+        const written = [];
+        for (const c of chosen) {
+            const dir = join(o.out, c.id);
+            rmSync(dir, { recursive: true, force: true });
+            mkdirSync(dir, { recursive: true });
+            writeFileSync(join(dir, 'input.json'), `${JSON.stringify(c.input, null, 2)}\n`);
+            writeFileSync(join(dir, 'expected.json'), `${JSON.stringify(c.expected, null, 2)}\n`);
+            written.push(c.id);
+        }
+        return { written, candidates: cases.length };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=golden-export.js.map

package/dist/review/golden-export.js.map

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

package/dist/review/impact.js

@@ -0,0 +1,406 @@
+// Impact drafts: changed file -> area -> user flows -> tests (docs/PR-REVIEW-QA.md 2.3).
+// Every area carries its sources (`via`) and the best confidence among them:
+// owner map 0.95, route 0.8 (0.7 when reached through imports), spec link 0.75,
+// component 0.7, path heuristics 0.5, CODEOWNERS 0.4.
+import { globMatch, globToRegExp } from './glob.js';
+import { areaOfRoute, exportedComponents, routeFromPath } from './routes.js';
+import { isNeighbourTest } from './specs.js';
+import { parseYaml } from './yaml.js';
+const VIA_ORDER = ['owner_map', 'route', 'spec_link', 'component', 'path', 'codeowners', 'reviewer'];
+// ---------- owner map and CODEOWNERS ----------
+function strings(v) {
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === 'string' || typeof x === 'number').map(String);
+    if (typeof v === 'string')
+        return [v];
+    return [];
+}
+/** Parses `.localdost/review.yml`: `areas: [{ name, paths: [globs], flows: [strings], specs: [globs] }]`. Throws on a bad shape. */
+export function parseOwnerMap(text) {
+    const doc = parseYaml(text);
+    if (!doc || typeof doc !== 'object' || Array.isArray(doc))
+        throw new Error('review.yml: top level must be a map');
+    const raw = doc.areas;
+    if (raw === undefined || raw === null)
+        return { areas: [] };
+    if (!Array.isArray(raw))
+        throw new Error('review.yml: areas must be a list');
+    const areas = [];
+    raw.forEach((a, i) => {
+        if (!a || typeof a !== 'object' || Array.isArray(a))
+            throw new Error(`review.yml: areas[${i}] must be a map`);
+        const name = typeof a.name === 'string' ? a.name.trim() : '';
+        if (!name)
+            throw new Error(`review.yml: areas[${i}] needs a name`);
+        const paths = strings(a.paths);
+        if (!paths.length)
+            throw new Error(`review.yml: area ${name} needs paths`);
+        areas.push({ name, paths, flows: strings(a.flows), specs: strings(a.specs) });
+    });
+    return { areas };
+}
+export function parseCodeowners(text) {
+    const out = [];
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.replace(/(^|\s)#.*$/, '').trim();
+        if (!line || line.startsWith('['))
+            continue;
+        const [pattern, ...owners] = line.split(/\s+/);
+        if (pattern)
+            out.push({ pattern, owners });
+    }
+    return out;
+}
+function codeownersMatch(pattern, path) {
+    const anchored = pattern.startsWith('/');
+    const p = pattern.replace(/^\//, '');
+    if (p === '*')
+        return true;
+    const inner = p.replace(/\/$/, '');
+    if (!anchored && !inner.includes('/'))
+        return globMatch(path, p);
+    if (p.endsWith('/'))
+        return path.startsWith(p) || globToRegExp(`${p}**`).test(path);
+    return globToRegExp(p).test(path) || globToRegExp(`${p}/**`).test(path);
+}
+/** Owners of a path: the last matching rule wins, as on GitHub. */
+export function ownersFor(rules, path) {
+    let hit;
+    for (const r of rules)
+        if (codeownersMatch(r.pattern, path))
+            hit = r;
+    return hit?.owners ?? [];
+}
+function teamArea(owner) {
+    const m = /^@[^/]+\/(.+)$/.exec(owner);
+    if (!m)
+        return null;
+    return m[1].replace(/[-_](team|squad|devs?|eng|engineering|owners?)$/i, '') || null;
+}
+// ---------- path heuristics ----------
+const ROOTS = new Set(['src', 'app', 'features', 'feature', 'modules', 'packages', 'apps']);
+const GENERIC = new Set([
+    'components',
+    'component',
+    'lib',
+    'libs',
+    'utils',
+    'util',
+    'hooks',
+    'shared',
+    'common',
+    'pages',
+    'routes',
+    'api',
+    'services',
+    'service',
+    'server',
+    'client',
+    'core',
+    'helpers',
+    'types',
+    'styles',
+    'assets',
+    'public',
+    'static',
+    'internal',
+    'ui',
+    'views',
+    'store',
+    'stores',
+    'models',
+    'controllers',
+    'config',
+    'middleware',
+    'test',
+    'tests',
+    '__tests__',
+    'e2e',
+    'spec',
+    'main',
+    'java',
+    'kotlin',
+    'resources',
+    'web',
+    'frontend',
+    'backend',
+    'migrations',
+    'db',
+]);
+export function slug(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function title(key) {
+    const words = key.replace(/-/g, ' ');
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+/** src/<area>/, app/<area>/, features/<area>/, modules/<area>/, packages/<area>/, apps/<area>/, skipping generic folders. */
+export function pathArea(path) {
+    const dirs = path.split('/').slice(0, -1);
+    for (let i = 0; i < dirs.length; i++) {
+        if (!ROOTS.has(dirs[i]))
+            continue;
+        for (let j = i + 1; j < dirs.length; j++) {
+            const d = dirs[j];
+            if (ROOTS.has(d))
+                break;
+            if (GENERIC.has(d) || /^[([@_]/.test(d) || d.startsWith('+'))
+                continue;
+            const s = slug(d);
+            if (s)
+                return s;
+        }
+    }
+    return null;
+}
+function specStem(path) {
+    return slug((path.split('/').pop() ?? path)
+        .replace(/\.(test|spec|e2e|cy)\.[^.]+$/, '')
+        .replace(/^test_/, '')
+        .replace(/_test\.[^.]+$/, '')
+        .replace(/\.[^.]+$/, ''));
+}
+// ---------- values a spec may depend on ----------
+function esc(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** True when the changed file defines a test id or a visible text that a spec uses. */
+export function definesValue(text, kind, value) {
+    if (value.length < 3)
+        return false;
+    if (kind === 'testid')
+        return new RegExp(`(?:data-(?:testid|test-id|test|cy|qa)|testId|testID|data_testid)\\s*[=:]\\s*\\{?\\s*["'\`]${esc(value)}["'\`]`).test(text);
+    return text.includes(`'${value}'`) || text.includes(`"${value}"`) || text.includes(`\`${value}\``) || new RegExp(`>\\s*${esc(value)}\\s*<`).test(text);
+}
+/** Head text of a changed file: the checkout copy, else the patch lines (added, context, hunk sections). */
+export function headText(view, f) {
+    const t = view.read(f.path);
+    if (t !== null)
+        return t;
+    const lines = new Map([...f.context, ...f.added]);
+    const body = [...lines.entries()].sort((a, b) => a[0] - b[0]).map(([, l]) => l);
+    return [...f.hunks.map((h) => h.section), ...body].join('\n');
+}
+const MAPPED_CLASSES = new Set(['source', 'config', 'migration']);
+export function buildImpactDrafts(x) {
+    const accs = new Map();
+    const fileAreas = new Map();
+    const add = (name, file, confidence, via, extra = {}) => {
+        const key = slug(name);
+        if (!key)
+            return;
+        let a = accs.get(key);
+        if (!a) {
+            a = {
+                key,
+                name: via === 'owner_map' ? name : title(key),
+                files: new Set(),
+                flows: new Set(),
+                routes: new Set(),
+                apiRoutes: new Set(),
+                confidence: 0,
+                via: new Set(),
+                ownerSpecs: [],
+            };
+            accs.set(key, a);
+        }
+        if (via === 'owner_map')
+            a.name = name;
+        a.files.add(file);
+        a.confidence = Math.max(a.confidence, confidence);
+        a.via.add(via);
+        for (const f of extra.flows ?? [])
+            a.flows.add(f);
+        for (const r of extra.routes ?? [])
+            a.routes.add(r);
+        for (const r of extra.apiRoutes ?? [])
+            a.apiRoutes.add(r);
+        for (const s of extra.ownerSpecs ?? [])
+            if (!a.ownerSpecs.includes(s))
+                a.ownerSpecs.push(s);
+        if (!fileAreas.has(file))
+            fileAreas.set(file, new Set());
+        fileAreas.get(file).add(key);
+    };
+    const texts = new Map();
+    const textOf = (f) => {
+        if (!texts.has(f.path))
+            texts.set(f.path, f.status === 'removed' ? '' : headText(x.view, f));
+        return texts.get(f.path);
+    };
+    const mapped = x.scope.files.filter((f) => MAPPED_CLASSES.has(f.class));
+    const unmapped = [];
+    for (const f of mapped) {
+        const path = f.path;
+        // 1. owner map
+        for (const oa of x.ownerMap?.areas ?? []) {
+            if (oa.paths.some((g) => globMatch(path, g)))
+                add(oa.name, path, 0.95, 'owner_map', { flows: oa.flows, ownerSpecs: oa.specs });
+        }
+        // 2. routes the file defines
+        const own = x.routesByFile.get(path) ?? (f.status === 'removed' ? [routeFromPath(path)].filter((r) => !!r) : []);
+        for (const r of own) {
+            const area = areaOfRoute(r.route);
+            if (area)
+                add(area, path, 0.8, 'route', {
+                    flows: [r.method ? `${r.method} ${r.route}` : r.route],
+                    routes: [r.route],
+                    ...(r.kind === 'api' ? { apiRoutes: [r.route] } : {}),
+                });
+        }
+        // 3. routes reached through imports (components get "component")
+        if (!own.length && !x.hubs.has(path)) {
+            const isComponent = exportedComponents(path, textOf(f)).length > 0;
+            const reachedRoutes = (x.reachedByFile.get(path) ?? []).filter((r) => !r.test && (x.routesByFile.get(r.file)?.length ?? 0) > 0).slice(0, 3);
+            for (const r of reachedRoutes) {
+                for (const def of x.routesByFile.get(r.file) ?? []) {
+                    const area = areaOfRoute(def.route);
+                    if (area)
+                        add(area, path, 0.7, isComponent ? 'component' : 'route', {
+                            flows: [def.method ? `${def.method} ${def.route}` : def.route],
+                            routes: [def.route],
+                            ...(def.kind === 'api' ? { apiRoutes: [def.route] } : {}),
+                        });
+                }
+            }
+        }
+        // 4. spec links when nothing above named an area
+        if (!fileAreas.get(path)?.size) {
+            const linked = specsTouchingFile(x, f, textOf(f));
+            for (const s of linked) {
+                const stem = specStem(s.spec);
+                if (stem)
+                    add(stem, path, 0.75, 'spec_link');
+            }
+        }
+        // 5. path heuristics
+        const pa = pathArea(path);
+        if (pa) {
+            if (fileAreas.get(path)?.has(pa))
+                accs.get(pa).via.add('path');
+            else if (!fileAreas.get(path)?.size)
+                add(pa, path, 0.5, 'path');
+        }
+        // 6. CODEOWNERS
+        if (!fileAreas.get(path)?.size && x.codeowners) {
+            for (const owner of ownersFor(x.codeowners, path)) {
+                const team = teamArea(owner);
+                if (team) {
+                    add(team, path, 0.4, 'codeowners');
+                    break;
+                }
+            }
+        }
+        if (!fileAreas.get(path)?.size)
+            unmapped.push(path);
+    }
+    // Spec links raise the via list of areas whose files a spec reaches.
+    for (const f of mapped) {
+        const keys = fileAreas.get(f.path);
+        if (!keys?.size)
+            continue;
+        if (specsTouchingFile(x, f, textOf(f)).length)
+            for (const k of keys)
+                accs.get(k).via.add('spec_link');
+    }
+    const sorted = [...accs.values()].sort((a, b) => b.confidence - a.confidence || (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
+    const areas = sorted.map((a, i) => ({
+        id: `a${i + 1}`,
+        area: a.name,
+        files: [...a.files].sort(),
+        userFlows: [...a.flows].sort(),
+        routes: a.routes.size ? [...a.routes].sort() : undefined,
+        ...(a.apiRoutes.size ? { apiRoutes: [...a.apiRoutes].sort() } : {}),
+        confidence: Math.round(Math.max(a.confidence, a.via.has('spec_link') ? 0.75 : 0) * 100) / 100,
+        via: VIA_ORDER.filter((v) => a.via.has(v)),
+    }));
+    const idByKey = new Map(sorted.map((a, i) => [a.key, `a${i + 1}`]));
+    const specLinks = linkSpecs(x, areas, sorted, idByKey, textOf);
+    const specsByArea = {};
+    for (const a of areas) {
+        const best = new Map();
+        for (const l of specLinks)
+            if (l.areaId === a.id)
+                best.set(l.spec, Math.max(best.get(l.spec) ?? 0, l.confidence));
+        specsByArea[a.id] = [...best.entries()].sort((p, q) => q[1] - p[1] || (p[0] < q[0] ? -1 : 1)).map(([s]) => s);
+    }
+    return { areas, unmappedFiles: unmapped.sort(), specLinks, specsByArea };
+}
+/** Specs that import the file (directly or through the walk), visit its routes, use its values, or sit next to it. */
+function specsTouchingFile(x, f, text) {
+    const reached = new Set((x.reachedByFile.get(f.path) ?? []).map((r) => r.file));
+    const routes = new Set((x.routesByFile.get(f.path) ?? []).map((r) => normRoute(r.route)));
+    const out = [];
+    for (const s of x.specs) {
+        if (s.imports.includes(f.path) ||
+            reached.has(s.path) ||
+            isNeighbourTest(s.path, f.path) ||
+            s.routes.some((r) => routes.has(normRoute(r))) ||
+            s.refs.some((r) => r.kind !== 'route' && definesValue(text, r.kind, r.value)))
+            out.push({ spec: s.path });
+    }
+    return out;
+}
+function normRoute(r) {
+    return (r.replace(/\/+$/, '') || '/').toLowerCase();
+}
+function routeCovers(areaRoute, specRoute) {
+    const a = normRoute(areaRoute);
+    const s = normRoute(specRoute);
+    if (a === s)
+        return true;
+    if (a === '/')
+        return false;
+    // Dynamic segments in the area route match any value.
+    const re = new RegExp(`^${a
+        .split('/')
+        .map((seg) => (/^(\[.*\]|:.*|\$.*)$/.test(seg) ? '[^/]+' : esc(seg)))
+        .join('/')}(/|$)`);
+    return re.test(s);
+}
+function linkSpecs(x, areas, accs, idByKey, textOf) {
+    const links = [];
+    const byPath = new Map(x.scope.files.map((f) => [f.path, f]));
+    for (const area of areas) {
+        const acc = accs.find((a) => idByKey.get(a.key) === area.id);
+        const areaFiles = new Set(area.files);
+        const reached = new Set();
+        for (const file of area.files)
+            for (const r of x.reachedByFile.get(file) ?? [])
+                reached.add(r.file);
+        for (const s of x.specs) {
+            const push = (via, confidence, refs = [], file) => links.push({ spec: s.path, areaId: area.id, via, confidence, refs, file });
+            if (acc.ownerSpecs.some((g) => globMatch(s.path, g)))
+                push('owner_map', 0.95);
+            if (area.files.some((file) => isNeighbourTest(s.path, file)))
+                push('neighbour', 0.9);
+            if (s.imports.some((i) => areaFiles.has(i)) || reached.has(s.path))
+                push('import', 0.75);
+            const routeRefs = s.refs.filter((r) => r.kind === 'route' && (area.routes ?? []).some((ar) => routeCovers(ar, r.value)));
+            if (routeRefs.length)
+                push('route', 0.75, routeRefs);
+            for (const kind of ['testid', 'text']) {
+                for (const file of area.files) {
+                    const f = byPath.get(file);
+                    if (!f || f.status === 'removed')
+                        continue;
+                    const text = textOf(f);
+                    const refs = s.refs.filter((r) => r.kind === kind && definesValue(text, kind, r.value));
+                    if (refs.length)
+                        push(kind, 0.75, refs, file);
+                }
+            }
+            const stem = specStem(s.path);
+            const key = slug(area.area);
+            if (key.length >= 3 && stem.split('-').includes(key))
+                push('name', 0.5);
+        }
+    }
+    return links.sort((a, b) => a.areaId === b.areaId
+        ? b.confidence - a.confidence || (a.spec < b.spec ? -1 : a.spec > b.spec ? 1 : a.via < b.via ? -1 : 1)
+        : Number(a.areaId.slice(1)) - Number(b.areaId.slice(1)));
+}
+//# sourceMappingURL=impact.js.map