@activate-core/test-forge 2.4.2 → 2.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/core/docs/doc-check.js +44 -8
- package/package.json +1 -1
|
@@ -55,7 +55,7 @@ export function buildDocCheckPrompt(doc, reference, excerpts, gaps, otherDocs =
|
|
|
55
55
|
excerpts || '(none found)',
|
|
56
56
|
`</source_excerpts>`,
|
|
57
57
|
`<draft>`,
|
|
58
|
-
doc,
|
|
58
|
+
withRuleIds(doc),
|
|
59
59
|
`</draft>`,
|
|
60
60
|
].join('\n');
|
|
61
61
|
}
|
|
@@ -72,6 +72,23 @@ export function parseFixes(out) {
|
|
|
72
72
|
}
|
|
73
73
|
const TAGGED = /\[(spec|baseline|observed)\]/i;
|
|
74
74
|
const norm = (t) => t.toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
|
|
75
|
+
/**
|
|
76
|
+
* The doc as the check sees it: every criterion starts with its id, also in a
|
|
77
|
+
* doc written before ids were part of the format, so a fix can name the rule
|
|
78
|
+
* it is about. The file itself is not changed.
|
|
79
|
+
*/
|
|
80
|
+
export function withRuleIds(markdown) {
|
|
81
|
+
const memory = readRules(markdown);
|
|
82
|
+
const lines = markdown.split('\n');
|
|
83
|
+
const where = ruleLines(lines, memory);
|
|
84
|
+
for (const r of memory.rules) {
|
|
85
|
+
const i = where.get(r.id);
|
|
86
|
+
if (i === undefined || r.explicit)
|
|
87
|
+
continue;
|
|
88
|
+
lines[i] = lines[i].replace(/^(\s*(?:[-*]|\d+(?:\.\d+)*\.?)\s+)/, `$1${r.id} `);
|
|
89
|
+
}
|
|
90
|
+
return lines.join('\n');
|
|
91
|
+
}
|
|
75
92
|
/** Line index of each rule's first line, by id. */
|
|
76
93
|
function ruleLines(lines, memory) {
|
|
77
94
|
const at = new Map();
|
|
@@ -122,11 +139,25 @@ export function applyFixes(markdown, fixes) {
|
|
|
122
139
|
const where = ruleLines(lines, memory);
|
|
123
140
|
const byRule = fixes.filter((f) => f.action !== 'add');
|
|
124
141
|
const removed = new Set();
|
|
142
|
+
// A fix names its rule by id; one that quotes the rule's words instead is matched by them.
|
|
143
|
+
const resolve = (ref) => {
|
|
144
|
+
const t = ref.trim();
|
|
145
|
+
const id = /^R\d+$/i.test(t) ? t.toUpperCase() : (/^R\d+\b/i.exec(t)?.[0]?.toUpperCase());
|
|
146
|
+
if (id && ids.has(id))
|
|
147
|
+
return id;
|
|
148
|
+
const want = norm(t.replace(/^R\d+\s*/i, ''));
|
|
149
|
+
if (want.length < 15)
|
|
150
|
+
return undefined;
|
|
151
|
+
const hit = memory.rules.find((r) => r.tag && (norm(r.text.split('\n')[0]).startsWith(want) || want.startsWith(norm(r.text.split('\n')[0]))));
|
|
152
|
+
return hit?.id;
|
|
153
|
+
};
|
|
154
|
+
for (const f of byRule)
|
|
155
|
+
f.rule = resolve(f.rule ?? '') ?? f.rule;
|
|
125
156
|
for (const f of byRule.sort((a, b) => (where.get(b.rule ?? '') ?? -1) - (where.get(a.rule ?? '') ?? -1))) {
|
|
126
|
-
const id = (f.rule ?? '').trim()
|
|
157
|
+
const id = (f.rule ?? '').trim();
|
|
127
158
|
const i = where.get(id);
|
|
128
159
|
if (!id || !ids.has(id) || i === undefined || removed.has(id)) {
|
|
129
|
-
refused.push(`${f.action} ${id || '(no rule)'}: the doc has no such rule`);
|
|
160
|
+
refused.push(`${f.action} ${id.length > 40 ? `"${id.slice(0, 40)}…"` : id || '(no rule)'}: the doc has no such rule`);
|
|
130
161
|
continue;
|
|
131
162
|
}
|
|
132
163
|
if (f.action === 'remove') {
|
|
@@ -223,10 +254,15 @@ export function withCoverage(markdown) {
|
|
|
223
254
|
lines.splice(before >= 0 ? before : lines.length, 0, ...table);
|
|
224
255
|
return lines.join('\n').replace(/\n{3,}/g, '\n\n');
|
|
225
256
|
}
|
|
226
|
-
/**
|
|
257
|
+
/** Markdown links read as their text: "[a](a)" is "a" once. */
|
|
258
|
+
const flatLinks = (t) => t.replace(/\[([^\]]*)\]\([^)]*\)/g, '$1');
|
|
259
|
+
/** The quoted words of a [spec] line's source, one entry per quote ("…" and \"…\" inside are kept). */
|
|
227
260
|
function quotesOf(line) {
|
|
228
|
-
const
|
|
229
|
-
|
|
261
|
+
const at = line.search(/\(source:/i);
|
|
262
|
+
if (at < 0)
|
|
263
|
+
return [];
|
|
264
|
+
const src = line.slice(at);
|
|
265
|
+
return [...src.matchAll(/["“]((?:\\.|[^"“”\\])*)["”]/g)].map((m) => flatLinks(m[1].replace(/\\"/g, '"')));
|
|
230
266
|
}
|
|
231
267
|
/**
|
|
232
268
|
* A [spec] line whose quote is not in the reference is the drafter's reading,
|
|
@@ -234,7 +270,7 @@ function quotesOf(line) {
|
|
|
234
270
|
* is checked piece by piece. Without a reference text nothing is checked.
|
|
235
271
|
*/
|
|
236
272
|
export function verifySpecQuotes(markdown, reference) {
|
|
237
|
-
const ref = ` ${norm(reference)} `;
|
|
273
|
+
const ref = ` ${norm(flatLinks(reference))} `;
|
|
238
274
|
const retagged = [];
|
|
239
275
|
if (!reference.trim())
|
|
240
276
|
return { markdown, retagged };
|
|
@@ -250,7 +286,7 @@ export function verifySpecQuotes(markdown, reference) {
|
|
|
250
286
|
const pieces = quotes.flatMap((q) => q.split(/…|\.\.\./)).map(norm).filter((p) => p.split(' ').length >= 3);
|
|
251
287
|
if (pieces.every((p) => ref.includes(` ${p} `)))
|
|
252
288
|
return line;
|
|
253
|
-
retagged.push(
|
|
289
|
+
retagged.push(/^\s*[-*]\s+(R\d+)\b/.exec(line)?.[1] ?? `"${line.replace(/^\s*[-*]\s+/, '').slice(0, 50)}…"`);
|
|
254
290
|
return line.replace(/\[spec\]/gi, '[observed]');
|
|
255
291
|
});
|
|
256
292
|
return { markdown: out.join('\n'), retagged };
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@activate-core/test-forge",
|
|
3
|
-
"version": "2.4.
|
|
3
|
+
"version": "2.4.3",
|
|
4
4
|
"description": "AI-powered QA automation. Scans a project, drafts journey docs, and generates seeded Jest/Playwright tests. Works in any project, with any AI CLI.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|