tinybeeai 0.0.0-stage → 0.16.1

package/dist/review/change-summary.js

@@ -0,0 +1,197 @@
+// Change summary (KAT-144): what a change does, which areas it touches, how big each part is and
+// how risky, for a QA engineer who will not read every diff. The reviewer writes `whatItDoes`
+// under the STE rules in ste.ts; everything else is computed here from the changed files and the
+// review, so the same input always gives the same areas, sizes and risks. When the model text is
+// missing or breaks the rules, a template writes whatItDoes from the areas.
+import { bannedWords, mentionsFile, steSentences, steWords, wordLimit } from './ste.js';
+/** Files whose line counts say nothing about the size of the change. */
+export function isNoiseFile(path) {
+    return (/(^|\/)(package-lock\.json|npm-shrinkwrap\.json|yarn\.lock|pnpm-lock\.yaml|Cargo\.lock|Gemfile\.lock|poetry\.lock|composer\.lock|go\.sum)$/.test(path) ||
+        /(^|\/)(dist|build|vendor|node_modules)\//.test(path) ||
+        /\.(min\.js|min\.css|map|snap)$/.test(path));
+}
+const SIZE_RANK = { small: 0, medium: 1, large: 2 };
+const RISK_RANK = { low: 0, medium: 1, high: 2 };
+/** small: under 50 changed lines and at most 3 files. large: 400 lines or more, or 15 files or more. Lock and build files do not count. */
+export function changeSize(files) {
+    const counted = files.filter((f) => !isNoiseFile(f.path));
+    const lines = counted.reduce((n, f) => n + f.additions + f.deletions, 0);
+    if (lines >= 400 || counted.length >= 15)
+        return 'large';
+    if (lines < 50 && counted.length <= 3)
+        return 'small';
+    return 'medium';
+}
+/** Risk of one area from the review's risks in it. A large area with no risk found is medium: nobody looked at all of it closely. */
+export function areaRisk(risks, areaId, size) {
+    // The verifier may lower a severity; the lowered one counts.
+    const sev = (risks ?? []).filter((r) => r.areaId === areaId && r.verifier?.status !== 'refuted').map((r) => r.verifier?.severity ?? r.severity);
+    if (sev.some((x) => x === 'critical' || x === 'high'))
+        return 'high';
+    if (sev.includes('medium'))
+        return 'medium';
+    return size === 'large' ? 'medium' : 'low';
+}
+const BUILD_TXT = /(^|\/)(requirements[^/]*\.txt|CMakeLists\.txt|constraints[^/]*\.txt)$/i;
+/** Path groups for files no review area lists. Ids carry a prefix so a model area id cannot collide with them. */
+const PATH_GROUPS = [
+    {
+        id: 'path-docs',
+        area: 'Documentation',
+        // requirements.txt and CMakeLists.txt are build files, not documentation.
+        test: (p) => !BUILD_TXT.test(p) && (/(^|\/)docs?\//i.test(p) || /\.(md|mdx|rst|txt)$/i.test(p)),
+    },
+    {
+        id: 'path-tests',
+        area: 'Automated tests',
+        test: (p) => /(^|\/)(tests?|e2e|__tests__|spec|cypress|playwright)\//i.test(p) || /\.(test|spec)\.[a-z]+$/i.test(p),
+    },
+    {
+        id: 'path-setup',
+        area: 'Build and setup',
+        test: (p) => isNoiseFile(p) ||
+            BUILD_TXT.test(p) ||
+            /(^|\/)(\.github|\.circleci|scripts)\//.test(p) ||
+            /(^|\/)(package\.json|Dockerfile|compose\.ya?ml|docker-compose\.ya?ml|Makefile|\.env\.example|renovate\.json|railway\.json)$/.test(p) ||
+            /(^|\/)(tsconfig[^/]*\.json|[^/]*\.config\.[cm]?[jt]s|\.eslintrc[^/]*|\.prettierrc[^/]*)$/.test(p),
+    },
+    { id: 'path-other', area: 'Other code', test: () => true },
+];
+function pathGroup(path) {
+    return PATH_GROUPS.find((g) => g.test(path));
+}
+/** Every changed file in exactly one area: the review's strongest area that lists it, else a path group. */
+export function summaryAreas(x) {
+    const review = [...(x.impactAreas ?? [])].sort((a, b) => b.confidence - a.confidence);
+    const buckets = new Map();
+    // The model may write "./src/x.ts" for "src/x.ts"; compare normalized paths.
+    const norm = (p) => p.trim().replace(/^\.\//, '').replace(/^\/+/, '');
+    const listed = review.map((a) => ({ a, files: new Set(a.files.map(norm)) }));
+    for (const f of x.files) {
+        const hit = listed.find((l) => l.files.has(norm(f.path)))?.a;
+        const key = hit ? hit.id : pathGroup(f.path).id;
+        let b = buckets.get(key);
+        if (!b) {
+            b = hit
+                ? { area: hit.area, userFlows: hit.userFlows, files: [], fromReview: true }
+                : { area: pathGroup(f.path).area, userFlows: [], files: [], fromReview: false };
+            buckets.set(key, b);
+        }
+        b.files.push(f);
+    }
+    const areas = [...buckets.entries()].map(([id, b]) => {
+        const size = changeSize(b.files);
+        return {
+            id,
+            area: b.area,
+            size,
+            risk: b.fromReview ? areaRisk(x.risks, id, size) : size === 'large' && id === 'path-other' ? 'medium' : 'low',
+            files: b.files.map((f) => f.path),
+            additions: b.files.reduce((n, f) => n + f.additions, 0),
+            deletions: b.files.reduce((n, f) => n + f.deletions, 0),
+            userFlows: b.userFlows,
+        };
+    });
+    // A risk whose area matched no changed file still counts: it raises the area that holds its evidence file.
+    for (const r of x.risks ?? []) {
+        if (r.verifier?.status === 'refuted' || (r.areaId && buckets.has(r.areaId)))
+            continue;
+        const file = r.evidence?.[0]?.file;
+        const target = file ? areas.find((a) => a.files.some((p) => norm(p) === norm(file))) : undefined;
+        if (!target)
+            continue;
+        const sev = r.verifier?.severity ?? r.severity;
+        const risk = sev === 'critical' || sev === 'high' ? 'high' : sev === 'medium' ? 'medium' : 'low';
+        if (RISK_RANK[risk] > RISK_RANK[target.risk])
+            target.risk = risk;
+    }
+    // Riskiest first, then the biggest, so the first chip is the one to test first.
+    const order = (a) => (buckets.get(a.id)?.fromReview ? 0 : 1);
+    return areas.sort((a, b) => RISK_RANK[b.risk] - RISK_RANK[a.risk] ||
+        order(a) - order(b) ||
+        SIZE_RANK[b.size] - SIZE_RANK[a.size] ||
+        b.additions + b.deletions - (a.additions + a.deletions) ||
+        a.area.localeCompare(b.area));
+}
+function wordCount(s) {
+    return s.trim().split(/\s+/).filter(Boolean).length;
+}
+function listNames(names) {
+    if (names.length <= 1)
+        return names[0] ?? '';
+    return `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;
+}
+/**
+ * Two or three STE sentences built from the areas alone, for when no model text keeps the rules.
+ * Area names go in only when the sentence stays short; the areas table names them all anyway.
+ */
+export function fallbackText(areas) {
+    if (!areas.length)
+        return 'This change has no changed files. There is nothing to test in the code.';
+    const ids = new Set(areas.map((a) => a.id));
+    const files = areas.reduce((n, a) => n + a.files.length, 0);
+    const only = (id) => ids.size === 1 && ids.has(`path-${id}`);
+    const fileWord = files === 1 ? '1 file' : `${files} files`;
+    if (only('docs'))
+        return `This change edits the documentation in ${fileWord}. The app does not change.`;
+    if (only('tests'))
+        return `This change edits automated tests only. The app does not change, but the test results can change.`;
+    if (only('setup'))
+        return `This change edits the build and setup files only. Install the app again and run the tests.`;
+    const out = [];
+    const names = areas.map((a) => a.area.trim());
+    const fits = (s, max) => wordCount(s) <= max;
+    if (areas.length === 1)
+        out.push(fits(names[0], 10) ? `This change touches ${names[0]}.` : 'This change touches one area.');
+    else {
+        const list = listNames(names);
+        out.push(fits(list, 16) ? `This change touches ${areas.length} areas: ${list}.` : `This change touches ${areas.length} areas.`);
+    }
+    const added = areas.reduce((n, a) => n + a.additions, 0);
+    const removed = areas.reduce((n, a) => n + a.deletions, 0);
+    const biggest = [...areas].sort((a, b) => b.additions + b.deletions - (a.additions + a.deletions))[0];
+    if (areas.length > 1 && fits(biggest.area, 12))
+        out.push(`Most of the changed lines are in ${biggest.area}.`);
+    else
+        out.push(`It adds ${added} lines and removes ${removed} lines in ${fileWord}.`);
+    const high = areas.find((a) => a.risk === 'high');
+    const medium = areas.find((a) => a.risk === 'medium');
+    const first = high ?? medium;
+    if (first) {
+        const why = high ? 'because the review found a high risk there' : 'because it has the most risk';
+        out.push(fits(first.area, 9) ? `Test ${first.area} first, ${why}.` : `Test the ${high ? 'high' : 'medium'} risk area first.`);
+    }
+    else
+        out.push('The review found no high or medium risk in the changed lines.');
+    return out.join(' ');
+}
+/** The model text when it keeps the rules, or the sentences of it that do; null when fewer than two survive. */
+export function acceptModelText(text) {
+    if (!text?.trim())
+        return null;
+    const flat = text
+        .replace(/\s+/g, ' ')
+        .replace(new RegExp(String.fromCharCode(0x2014), 'g'), ',')
+        .trim();
+    const keep = steSentences(flat).filter((s) => steWords(s) <= wordLimit(s) && !mentionsFile(s) && !bannedWords(s).length);
+    if (keep.length < 2)
+        return null;
+    return keep.slice(0, 3).join(' ');
+}
+export function buildChangeSummary(x) {
+    const areas = summaryAreas(x);
+    const model = acceptModelText(x.modelText);
+    const review = model ? null : acceptModelText(x.reviewSummary);
+    return {
+        whatItDoes: model ?? review ?? fallbackText(areas),
+        source: model ? 'model' : 'fallback',
+        size: changeSize(x.files),
+        files: x.files.length,
+        additions: x.files.reduce((n, f) => n + f.additions, 0),
+        deletions: x.files.reduce((n, f) => n + f.deletions, 0),
+        areas,
+    };
+}
+export const SIZE_WORD = { small: 'Small', medium: 'Medium', large: 'Large' };
+export const RISK_WORD = { low: 'Low', medium: 'Medium', high: 'High' };
+//# sourceMappingURL=change-summary.js.map

package/dist/review/change-summary.js.map

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

package/dist/review/changelog.js

@@ -0,0 +1,40 @@
+const CHANGELOG = 'CHANGELOG.md';
+const PRODUCT = /^(src|client)\//;
+const TEST_FILE = /(\.test\.[cm]?[jt]sx?$)|(^client\/src\/test\/)/;
+const BULLET = /^\s*[-*]\s+\S/;
+function isProductFile(f) {
+    return PRODUCT.test(f.path) && !TEST_FILE.test(f.path) && f.class !== 'test';
+}
+/** True when the patch of CHANGELOG.md adds a bullet under the Unreleased heading. */
+function addsUnreleasedEntry(file) {
+    for (const hunk of file.hunks) {
+        // The heading that governs a line is the last "## " line before it in the hunk. When the hunk shows
+        // none, the line counts as Unreleased: a normal change does not edit released sections.
+        let heading = null;
+        for (const line of hunk.lines) {
+            if (line.t === '-')
+                continue;
+            if (/^##\s/.test(line.text))
+                heading = line.text;
+            else if (line.t === '+' && BULLET.test(line.text) && (heading === null || /\[?unreleased\]?/i.test(heading)))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * The note for a review, or null. Null when no product code changed, when the repo has no
+ * CHANGELOG.md, when the diff has no line data for it, or when it adds an Unreleased entry.
+ */
+export function changelogNote(scope, repoFiles = []) {
+    const product = scope.files.filter((f) => isProductFile(f));
+    if (!product.length)
+        return null;
+    const changelog = scope.files.find((f) => f.path === CHANGELOG);
+    if (!changelog)
+        return repoFiles.includes(CHANGELOG) ? { file: CHANGELOG } : null;
+    if (changelog.uncovered || changelog.source === 'none')
+        return null;
+    return addsUnreleasedEntry(changelog) ? null : { file: CHANGELOG };
+}
+//# sourceMappingURL=changelog.js.map

package/dist/review/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../src/review/changelog.ts"],"names":[],"mappings":"AASA,MAAM,SAAS,GAAG,cAAc,CAAC;AACjC,MAAM,OAAO,GAAG,iBAAiB,CAAC;AAClC,MAAM,SAAS,GAAG,gDAAgD,CAAC;AACnE,MAAM,MAAM,GAAG,eAAe,CAAC;AAE/B,SAAS,aAAa,CAAC,CAAY;IACjC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC;AAC/E,CAAC;AAED,sFAAsF;AACtF,SAAS,mBAAmB,CAAC,IAAe;IAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,oGAAoG;QACpG,wFAAwF;QACxF,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG;gBAAE,SAAS;YAC7B,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;iBAC5C,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC5H,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB,EAAE,YAA+B,EAAE;IACjF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAChE,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,IAAI,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpE,OAAO,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACrE,CAAC"}