@ia-qa/qa-discovery 0.1.2 → 0.2.0
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/README.md +52 -1
- package/TUTORIAL.md +433 -0
- package/dist/cli/args.js +1 -0
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/coverage.d.ts +20 -0
- package/dist/cli/coverage.js +178 -0
- package/dist/cli/coverage.js.map +1 -0
- package/dist/cli/index.d.ts +1 -1
- package/dist/cli/index.js +23 -0
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/scan.d.ts +3 -1
- package/dist/cli/scan.js +3 -2
- package/dist/cli/scan.js.map +1 -1
- package/dist/config.d.ts +13 -0
- package/dist/config.js.map +1 -1
- package/dist/coverage.d.ts +126 -0
- package/dist/coverage.js +243 -0
- package/dist/coverage.js.map +1 -0
- package/dist/coverageView.d.ts +28 -0
- package/dist/coverageView.js +154 -0
- package/dist/coverageView.js.map +1 -0
- package/dist/htmlReport.js +8 -1
- package/dist/htmlReport.js.map +1 -1
- package/dist/mcp/server.d.ts +28 -0
- package/dist/mcp/server.js +47 -0
- package/dist/mcp/server.js.map +1 -1
- package/dist/overview.d.ts +9 -0
- package/dist/overview.js +10 -1
- package/dist/overview.js.map +1 -1
- package/dist/overviewFile.js +23 -0
- package/dist/overviewFile.js.map +1 -1
- package/package.json +62 -61
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
14
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
15
|
+
}) : function(o, v) {
|
|
16
|
+
o["default"] = v;
|
|
17
|
+
});
|
|
18
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
19
|
+
var ownKeys = function(o) {
|
|
20
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
21
|
+
var ar = [];
|
|
22
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
23
|
+
return ar;
|
|
24
|
+
};
|
|
25
|
+
return ownKeys(o);
|
|
26
|
+
};
|
|
27
|
+
return function (mod) {
|
|
28
|
+
if (mod && mod.__esModule) return mod;
|
|
29
|
+
var result = {};
|
|
30
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
31
|
+
__setModuleDefault(result, mod);
|
|
32
|
+
return result;
|
|
33
|
+
};
|
|
34
|
+
})();
|
|
35
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
|
+
exports.COVERAGE_FILENAME = void 0;
|
|
37
|
+
exports.coverageMapPath = coverageMapPath;
|
|
38
|
+
exports.runCoverage = runCoverage;
|
|
39
|
+
const fs = __importStar(require("fs"));
|
|
40
|
+
const path = __importStar(require("path"));
|
|
41
|
+
const config_1 = require("../config");
|
|
42
|
+
const coverage_1 = require("../coverage");
|
|
43
|
+
const coverageView_1 = require("../coverageView");
|
|
44
|
+
const overviewFile_1 = require("../overviewFile");
|
|
45
|
+
const htmlReport_1 = require("../htmlReport");
|
|
46
|
+
const citations_1 = require("../citations");
|
|
47
|
+
const sharedCalls_1 = require("../sharedCalls");
|
|
48
|
+
const scan_1 = require("./scan");
|
|
49
|
+
/**
|
|
50
|
+
* `ia-qa-discover coverage` — what the suite tests, what the app has, and the gap.
|
|
51
|
+
*
|
|
52
|
+
* **A verb, not a flag on `scan`.** It reads local files only and opens no browser; making
|
|
53
|
+
* it a flag would force a full re-crawl of the application to read two files already on
|
|
54
|
+
* disk. It is also opt-in for a reason that matters more: `scan` must stay silent about the
|
|
55
|
+
* sibling package, because a cross-reference that fires on the ordinary run is advertising,
|
|
56
|
+
* and this package treats a message that fires on the good case as a defect. Here the user
|
|
57
|
+
* asked, so the premise of their own command is what is missing — that is an answer.
|
|
58
|
+
*
|
|
59
|
+
* **Plug-and-play has a precise test here**: in a project that already has `.ia-qa/` and
|
|
60
|
+
* `.ia-qa-discovery/`, the bare verb produces the map with no argument and no question.
|
|
61
|
+
*
|
|
62
|
+
* Exit code is 0 on a refusal as well as on a gap. A missing optional prerequisite is not a
|
|
63
|
+
* failure of anything, and a coverage gap is a decision for a human — gating on it would
|
|
64
|
+
* make this the verdict discovery has spent its whole design refusing to emit.
|
|
65
|
+
*/
|
|
66
|
+
exports.COVERAGE_FILENAME = 'coverage-map.json';
|
|
67
|
+
function coverageMapPath(cwd = (0, config_1.baseDir)()) {
|
|
68
|
+
return path.join(cwd, '.ia-qa-discovery', exports.COVERAGE_FILENAME);
|
|
69
|
+
}
|
|
70
|
+
async function runCoverage(args) {
|
|
71
|
+
const json = args.includes('--json');
|
|
72
|
+
const config = (() => {
|
|
73
|
+
try {
|
|
74
|
+
return (0, config_1.loadConfig)();
|
|
75
|
+
}
|
|
76
|
+
catch {
|
|
77
|
+
return null;
|
|
78
|
+
}
|
|
79
|
+
})();
|
|
80
|
+
const outcome = (0, coverage_1.computeCoverage)({
|
|
81
|
+
captureDirPath: (0, config_1.captureDir)(),
|
|
82
|
+
healingDirPath: path.join((0, config_1.baseDir)(), coverage_1.HEALING_DIR),
|
|
83
|
+
scope: config?.outOfScope,
|
|
84
|
+
});
|
|
85
|
+
if (!outcome.ok) {
|
|
86
|
+
emitRefusal(outcome.refusal, json);
|
|
87
|
+
return;
|
|
88
|
+
}
|
|
89
|
+
const file = writeMap(outcome.map);
|
|
90
|
+
// `scan` writes `_overview.md` before any coverage map exists, so the map would otherwise
|
|
91
|
+
// first appear there on the *next* scan — stale by construction. Same reason, and the same
|
|
92
|
+
// mechanism, as the AI layer rewriting it after a classification.
|
|
93
|
+
//
|
|
94
|
+
// A refusal here is REPORTED, never swallowed: `_overview.md` is the file people open and
|
|
95
|
+
// paste into a review, and letting someone believe it carries a section it does not have
|
|
96
|
+
// is the silent behaviour this package treats as a defect. It is not fatal — the map on
|
|
97
|
+
// screen and on disk is the product.
|
|
98
|
+
const refreshed = (0, overviewFile_1.refreshOverview)();
|
|
99
|
+
if (!refreshed.ok && !json) {
|
|
100
|
+
console.log(`\n⚠ _overview.md was NOT updated with this gap: ${refreshed.reason}`);
|
|
101
|
+
}
|
|
102
|
+
// The HTML surface. Written from the map computed *just now* against the capture on disk,
|
|
103
|
+
// never from a map left over from an earlier moment — a gap computed over a different set
|
|
104
|
+
// of pages, rendered beside a fresh capture, is a number that describes neither.
|
|
105
|
+
const wantedReport = (0, scan_1.reportPath)(args, 'ia-qa-discover-coverage.html');
|
|
106
|
+
let writtenReport;
|
|
107
|
+
if (wantedReport) {
|
|
108
|
+
writtenReport = writeReport(wantedReport, outcome.map, args.includes('--open'));
|
|
109
|
+
}
|
|
110
|
+
if (json) {
|
|
111
|
+
console.log(JSON.stringify(outcome.map, null, 2));
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
console.log((0, coverageView_1.renderCoverageTerminal)(outcome.map));
|
|
115
|
+
if (file)
|
|
116
|
+
console.log(`\n Written to ${path.relative(process.cwd(), file) || file}`);
|
|
117
|
+
if (writtenReport)
|
|
118
|
+
console.log(` Report → ${path.relative(process.cwd(), writtenReport) || writtenReport}`);
|
|
119
|
+
}
|
|
120
|
+
/** The branded dossier, with the gap as a section of the surface it was computed against. */
|
|
121
|
+
function writeReport(wanted, map, open) {
|
|
122
|
+
const surface = (0, coverage_1.loadSurface)((0, config_1.captureDir)());
|
|
123
|
+
if (!surface)
|
|
124
|
+
return undefined;
|
|
125
|
+
const index = (0, citations_1.loadCaptureIndex)((0, config_1.captureDir)());
|
|
126
|
+
const shared = index.shared ?? {
|
|
127
|
+
schema: sharedCalls_1.SHARED_CALLS_SCHEMA,
|
|
128
|
+
capturedAt: surface.manifest.capturedAt,
|
|
129
|
+
sourcePages: 0,
|
|
130
|
+
threshold: 0,
|
|
131
|
+
calls: [],
|
|
132
|
+
};
|
|
133
|
+
const file = path.resolve(process.cwd(), wanted);
|
|
134
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
135
|
+
fs.writeFileSync(file, (0, htmlReport_1.renderScanReport)({
|
|
136
|
+
manifest: surface.manifest,
|
|
137
|
+
pages: surface.pages,
|
|
138
|
+
shared,
|
|
139
|
+
...surface.manifest.coverage,
|
|
140
|
+
coverageMap: map,
|
|
141
|
+
}), 'utf8');
|
|
142
|
+
if (open)
|
|
143
|
+
(0, scan_1.openInBrowser)(file);
|
|
144
|
+
return file;
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* A refusal is a typed reason, never an empty map.
|
|
148
|
+
*
|
|
149
|
+
* `{}` or a zero count reads to an agent as "this app is fully covered", which is the worst
|
|
150
|
+
* sentence this tool could cause to be written. The human form says what remains available
|
|
151
|
+
* *precisely* — "not computed", never "less accurate", because only one of those is true.
|
|
152
|
+
*/
|
|
153
|
+
function emitRefusal(r, json) {
|
|
154
|
+
if (json) {
|
|
155
|
+
console.log(JSON.stringify({ schema: coverage_1.COVERAGE_SCHEMA, measured: false, reason: r.reason, available: r.available }, null, 2));
|
|
156
|
+
return;
|
|
157
|
+
}
|
|
158
|
+
console.log(`\nℹ️ ${r.message}`);
|
|
159
|
+
if (r.available.length > 0) {
|
|
160
|
+
console.log(`\n Still available, unchanged:`);
|
|
161
|
+
for (const a of r.available)
|
|
162
|
+
console.log(` · ${a}`);
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
function writeMap(map) {
|
|
166
|
+
try {
|
|
167
|
+
const file = coverageMapPath();
|
|
168
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
169
|
+
fs.writeFileSync(file, JSON.stringify(map, null, 2) + '\n', 'utf8');
|
|
170
|
+
return file;
|
|
171
|
+
}
|
|
172
|
+
catch {
|
|
173
|
+
// The map on screen is the product; a disk that will not take the file must not turn
|
|
174
|
+
// a successful measurement into a failure.
|
|
175
|
+
return null;
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
//# sourceMappingURL=coverage.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/cli/coverage.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
declare const HELP = "ia-qa-discover \u2014 deterministic surface reconnaissance for a web app\n\nF1 of QA Discovery: crawl an app's same-origin pages and capture what each one\nis structurally about \u2014 title, headings, forms, and observed API calls. No\nLLM, no verdict: this is recon, not a gate. Runs entirely on your machine;\nnothing is uploaded anywhere.\n\n[FOR AI AGENTS] You are driving this for a human. Run `scan` to capture the\napp's surface, then read .ia-qa-discovery/capture/surface.json (the index) and\nthe per-page files it points at \u2014 that is the evidence for anything you\nreport about this app. Never assert a page's purpose or risk from the URL\nalone; ground it in the captured meta/headings/forms/apiCalls. Never read a\npage count as coverage: if scan warns that pages still show a login form, you\nmeasured the wall, not the app. You CANNOT run `login` \u2014 it waits for a human\nat a browser; ask them to run it, then scan again.\n\nUsage:\n ia-qa-discover login Open a visible browser, log in by hand, keep the\n session (.ia-qa-discovery/session.json) for scan\n to reuse. The general answer to a login wall: it\n models nothing, so SSO, MFA, a consent screen or\n a magic link all work \u2014 you do them.\n Needs a terminal, refuses under CI. The file holds\n live cookies: gitignored, stays on this machine.\n --url <path> page to open (default: your baseUrl)\n --session <f> where to write it\n Already have a storageState (a Playwright globalSetup\n writes one)? Skip this verb: point scan at it with\n --session <file> or \"session\" in config.json.\n ia-qa-discover scan [url] Crawl same-origin pages from <url> (or the saved\n baseUrl) and capture each page's structure.\n Writes .ia-qa-discovery/capture/, diffs against\n the previous run, appends history.jsonl.\n --depth <n> crawl link-depth (default 2)\n --max <n> page cap (default 60)\n --deep also open menus, tabs and dialogs one level\n down and capture the fields they reveal. Every\n non-GET request is blocked for the duration,\n so a click cannot mutate anything server-side.\n --deep-budget <n> max controls clicked per page (default 60)\n --no-sitemap do not read sitemap.xml / robots.txt\n --no-reveal do not open menus/dropdowns for hidden links\n --strict-host treat www./apex as different hosts\n --session <file> reuse an existing storageState (login) file\n --no-network skip API/network-call capture this run\n --network-threshold <n> shared-call promotion threshold 0-1 (default 0.6)\n --save persist this baseUrl to config.json\n --json machine-readable summary on stdout\n --report [file.html] branded ia-qa.com HTML dossier of the\n app (default ia-qa-discover-report.html)\n --open open that report in the browser\n ia-qa-discover history Recorded scan runs \u2014 pages/forms/API-surface trend.\n --json --limit <n> (default 500)\n ia-qa-discover version Print the installed version (also --version, -v)\n ia-qa-discover help Show this help\n\nGlobal:\n --config <dir> Resolve .ia-qa-discovery/ under <dir> instead of the\n current directory. Also IAQA_DISCOVERY_CONFIG_DIR=<dir>.\n";
|
|
2
|
+
declare const HELP = "ia-qa-discover \u2014 deterministic surface reconnaissance for a web app\n\nF1 of QA Discovery: crawl an app's same-origin pages and capture what each one\nis structurally about \u2014 title, headings, forms, and observed API calls. No\nLLM, no verdict: this is recon, not a gate. Runs entirely on your machine;\nnothing is uploaded anywhere.\n\n[FOR AI AGENTS] You are driving this for a human. Run `scan` to capture the\napp's surface, then read .ia-qa-discovery/capture/surface.json (the index) and\nthe per-page files it points at \u2014 that is the evidence for anything you\nreport about this app. Never assert a page's purpose or risk from the URL\nalone; ground it in the captured meta/headings/forms/apiCalls. Never read a\npage count as coverage: if scan warns that pages still show a login form, you\nmeasured the wall, not the app. You CANNOT run `login` \u2014 it waits for a human\nat a browser; ask them to run it, then scan again.\n`coverage` answers \"what does their suite NOT test\" \u2014 but only from a suite that was\nwatched running (@ia-qa/self-healing + one `ia-qa-heal run`). If it says there is no\nmeasurement, report that, never \"the suite covers nothing\": a contract means someone\nconfigured a page, only a watched run means a test went there.\n\nUsage:\n ia-qa-discover login Open a visible browser, log in by hand, keep the\n session (.ia-qa-discovery/session.json) for scan\n to reuse. The general answer to a login wall: it\n models nothing, so SSO, MFA, a consent screen or\n a magic link all work \u2014 you do them.\n Needs a terminal, refuses under CI. The file holds\n live cookies: gitignored, stays on this machine.\n --url <path> page to open (default: your baseUrl)\n --session <f> where to write it\n Already have a storageState (a Playwright globalSetup\n writes one)? Skip this verb: point scan at it with\n --session <file> or \"session\" in config.json.\n ia-qa-discover scan [url] Crawl same-origin pages from <url> (or the saved\n baseUrl) and capture each page's structure.\n Writes .ia-qa-discovery/capture/, diffs against\n the previous run, appends history.jsonl.\n --depth <n> crawl link-depth (default 2)\n --max <n> page cap (default 60)\n --deep also open menus, tabs and dialogs one level\n down and capture the fields they reveal. Every\n non-GET request is blocked for the duration,\n so a click cannot mutate anything server-side.\n --deep-budget <n> max controls clicked per page (default 60)\n --no-sitemap do not read sitemap.xml / robots.txt\n --no-reveal do not open menus/dropdowns for hidden links\n --strict-host treat www./apex as different hosts\n --session <file> reuse an existing storageState (login) file\n --no-network skip API/network-call capture this run\n --network-threshold <n> shared-call promotion threshold 0-1 (default 0.6)\n --save persist this baseUrl to config.json\n --json machine-readable summary on stdout\n --report [file.html] branded ia-qa.com HTML dossier of the\n app (default ia-qa-discover-report.html)\n --open open that report in the browser\n ia-qa-discover coverage What your test suite does NOT test. Compares the\n pages this scan found against the pages your suite\n was OBSERVED visiting, ranks the gap by what each\n page takes as input, and writes coverage-map.json.\n Reads local files only \u2014 no browser, no network.\n Needs @ia-qa/self-healing and one \"ia-qa-heal run\":\n without a watched run there is no measurement, and\n it says so instead of showing a number.\n Declare pages you deliberately do not test in\n \"outOfScope\" in config.json \u2014 they stay counted\n and named, never silently dropped.\n --json machine-readable map on stdout\n --report [file.html] branded HTML dossier with the gap\n (default ia-qa-discover-coverage.html)\n --open open that report in the browser\n ia-qa-discover history Recorded scan runs \u2014 pages/forms/API-surface trend.\n --json --limit <n> (default 500)\n ia-qa-discover version Print the installed version (also --version, -v)\n ia-qa-discover help Show this help\n\nGlobal:\n --config <dir> Resolve .ia-qa-discovery/ under <dir> instead of the\n current directory. Also IAQA_DISCOVERY_CONFIG_DIR=<dir>.\n";
|
|
3
3
|
declare function verbHelp(command: string | undefined): string | null;
|
|
4
4
|
declare function main(): Promise<void>;
|
|
5
5
|
export { HELP, verbHelp, main };
|
package/dist/cli/index.js
CHANGED
|
@@ -9,6 +9,7 @@ const args_1 = require("./args");
|
|
|
9
9
|
const scan_1 = require("./scan");
|
|
10
10
|
const login_1 = require("./login");
|
|
11
11
|
const history_1 = require("./history");
|
|
12
|
+
const coverage_1 = require("./coverage");
|
|
12
13
|
// dist/cli/ → package root; npm ships package.json in every tarball.
|
|
13
14
|
const VERSION = require('../../package.json').version;
|
|
14
15
|
const HELP = `ia-qa-discover — deterministic surface reconnaissance for a web app
|
|
@@ -26,6 +27,10 @@ alone; ground it in the captured meta/headings/forms/apiCalls. Never read a
|
|
|
26
27
|
page count as coverage: if scan warns that pages still show a login form, you
|
|
27
28
|
measured the wall, not the app. You CANNOT run \`login\` — it waits for a human
|
|
28
29
|
at a browser; ask them to run it, then scan again.
|
|
30
|
+
\`coverage\` answers "what does their suite NOT test" — but only from a suite that was
|
|
31
|
+
watched running (@ia-qa/self-healing + one \`ia-qa-heal run\`). If it says there is no
|
|
32
|
+
measurement, report that, never "the suite covers nothing": a contract means someone
|
|
33
|
+
configured a page, only a watched run means a test went there.
|
|
29
34
|
|
|
30
35
|
Usage:
|
|
31
36
|
ia-qa-discover login Open a visible browser, log in by hand, keep the
|
|
@@ -62,6 +67,21 @@ Usage:
|
|
|
62
67
|
--report [file.html] branded ia-qa.com HTML dossier of the
|
|
63
68
|
app (default ia-qa-discover-report.html)
|
|
64
69
|
--open open that report in the browser
|
|
70
|
+
ia-qa-discover coverage What your test suite does NOT test. Compares the
|
|
71
|
+
pages this scan found against the pages your suite
|
|
72
|
+
was OBSERVED visiting, ranks the gap by what each
|
|
73
|
+
page takes as input, and writes coverage-map.json.
|
|
74
|
+
Reads local files only — no browser, no network.
|
|
75
|
+
Needs @ia-qa/self-healing and one "ia-qa-heal run":
|
|
76
|
+
without a watched run there is no measurement, and
|
|
77
|
+
it says so instead of showing a number.
|
|
78
|
+
Declare pages you deliberately do not test in
|
|
79
|
+
"outOfScope" in config.json — they stay counted
|
|
80
|
+
and named, never silently dropped.
|
|
81
|
+
--json machine-readable map on stdout
|
|
82
|
+
--report [file.html] branded HTML dossier with the gap
|
|
83
|
+
(default ia-qa-discover-coverage.html)
|
|
84
|
+
--open open that report in the browser
|
|
65
85
|
ia-qa-discover history Recorded scan runs — pages/forms/API-surface trend.
|
|
66
86
|
--json --limit <n> (default 500)
|
|
67
87
|
ia-qa-discover version Print the installed version (also --version, -v)
|
|
@@ -134,6 +154,9 @@ async function main() {
|
|
|
134
154
|
case 'login':
|
|
135
155
|
await (0, login_1.runLogin)(rest);
|
|
136
156
|
break;
|
|
157
|
+
case 'coverage':
|
|
158
|
+
await (0, coverage_1.runCoverage)(rest);
|
|
159
|
+
break;
|
|
137
160
|
case 'history':
|
|
138
161
|
await (0, history_1.runHistory)(rest);
|
|
139
162
|
break;
|
package/dist/cli/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/scan.d.ts
CHANGED
|
@@ -7,5 +7,7 @@ export declare function floatArg(args: string[], flag: string): number | undefin
|
|
|
7
7
|
* `--report out.html` names it. The token after the flag is only a value when
|
|
8
8
|
* it is not itself a flag and not the positional URL.
|
|
9
9
|
*/
|
|
10
|
-
export declare function reportPath(args: string[]): string | undefined;
|
|
10
|
+
export declare function reportPath(args: string[], fallback?: string): string | undefined;
|
|
11
|
+
/** Open a local file in the default browser. Never under CI — nothing there to look at. */
|
|
12
|
+
export declare function openInBrowser(file: string): void;
|
|
11
13
|
export declare function runScan(args: string[]): Promise<void>;
|
package/dist/cli/scan.js
CHANGED
|
@@ -38,6 +38,7 @@ exports.stringArg = stringArg;
|
|
|
38
38
|
exports.intArg = intArg;
|
|
39
39
|
exports.floatArg = floatArg;
|
|
40
40
|
exports.reportPath = reportPath;
|
|
41
|
+
exports.openInBrowser = openInBrowser;
|
|
41
42
|
exports.runScan = runScan;
|
|
42
43
|
const fs = __importStar(require("fs"));
|
|
43
44
|
const path = __importStar(require("path"));
|
|
@@ -97,13 +98,13 @@ const DEFAULT_REPORT = 'ia-qa-discover-report.html';
|
|
|
97
98
|
* `--report out.html` names it. The token after the flag is only a value when
|
|
98
99
|
* it is not itself a flag and not the positional URL.
|
|
99
100
|
*/
|
|
100
|
-
function reportPath(args) {
|
|
101
|
+
function reportPath(args, fallback = DEFAULT_REPORT) {
|
|
101
102
|
const i = args.indexOf('--report');
|
|
102
103
|
if (i === -1)
|
|
103
104
|
return undefined;
|
|
104
105
|
const next = args[i + 1];
|
|
105
106
|
if (!next || next.startsWith('-') || /^https?:\/\//i.test(next))
|
|
106
|
-
return
|
|
107
|
+
return fallback;
|
|
107
108
|
return next;
|
|
108
109
|
}
|
|
109
110
|
/** Open a local file in the default browser. Never under CI — nothing there to look at. */
|
package/dist/cli/scan.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/cli/scan.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,0CAWC;AAED,8BAMC;AAED,wBASC;AAED,4BASC;AAWD,gCAMC;
|
|
1
|
+
{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/cli/scan.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,0CAWC;AAED,8BAMC;AAED,wBASC;AAED,4BASC;AAWD,gCAMC;AAGD,sCAUC;AAED,0BAkIC;AAnND,uCAAyB;AACzB,2CAA6B;AAC7B,iDAAsC;AACtC,kCAAkC;AAClC,8CAAiD;AACjD,8DAA0D;AAC1D,gDAAkE;AAElE,SAAgB,eAAe,CAAC,IAAc,EAAE,UAAoB;IAClE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,SAAS,CAAC,IAAc,EAAE,IAAY;IACpD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iBAAiB,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,MAAM,CAAC,IAAc,EAAE,IAAY,EAAE,GAAW;IAC9D,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uCAAuC,GAAG,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAgB,QAAQ,CAAC,IAAc,EAAE,IAAY;IACnD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,kCAAkC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;AAE1G,MAAM,cAAc,GAAG,4BAA4B,CAAC;AAEpD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAc,EAAE,WAAmB,cAAc;IAC1E,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2FAA2F;AAC3F,SAAgB,aAAa,CAAC,IAAY;IACxC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO;IAC3B,MAAM,GAAG,GACP,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IAC7F,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/E,IAAI,CAAC;QACH,IAAA,qBAAK,EAAC,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,oEAAoE;IACpE,wEAAwE;IACxE,4EAA4E;IAC5E,4EAA4E;IAC5E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,MAAM,IAAA,cAAO,EAAC;QAC3B,GAAG;QACH,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;QACrC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;QACrC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACxD,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC7D,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC;QACrC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC1D,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC1D,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAChD,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,CAAC;QAC9C,gBAAgB,EAAE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;QACvD,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG;KACnC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,IAAA,sCAAiB,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,aAAiC,CAAC;IACtC,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;QACvD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,EAAE,CAAC,aAAa,CACd,IAAI,EACJ,IAAA,6BAAgB,EAAC;YACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY;YAC3C,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,IAAI,IAAI;YAC3D,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,oEAAoE;YACpE,kEAAkE;YAClE,wEAAwE;YACxE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC,EACF,MAAM,CACP,CAAC;QACF,aAAa,GAAG,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzG,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CACT,KAAK,MAAM,CAAC,aAAa,OAAO,MAAM,CAAC,UAAU,mBAAmB;QAClE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CACvE,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9F,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3G,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,0EAA0E;IAC1E,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,aAAa,OAAO,MAAM,CAAC,UAAU,kDAAkD,CAAC,CAAC;QACnH,OAAO,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC;QACrG,OAAO,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC;QACvG,OAAO,CAAC,GAAG,CAAC,qCAAqC,gCAAgC,6BAA6B,CAAC,CAAC;IAClH,CAAC;SAAM,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,yEAAyE;QACzE,0EAA0E;QAC1E,+DAA+D;QAC/D,OAAO,CAAC,GAAG,CACT,QAAQ,MAAM,CAAC,SAAS,CAAC,MAAM,OAAO,MAAM,CAAC,aAAa,4CAA4C;YACpG,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACtC,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,+FAA+F,CAAC,CAAC;QAC7G,OAAO,CAAC,GAAG,CACT,MAAM,CAAC,OAAO;YACZ,CAAC,CAAC,yBAAyB,MAAM,CAAC,OAAO,8EAA8E;YACvH,CAAC,CAAC,0EAA0E,CAC/E,CAAC;IACJ,CAAC;SAAM,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC5D,sEAAsE;QACtE,oEAAoE;QACpE,+DAA+D;QAC/D,OAAO,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;QAC5F,OAAO,CAAC,GAAG,CAAC,+FAA+F,CAAC,CAAC;QAC7G,OAAO,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAC;IAC1F,CAAC;SAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,wCAAwC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,6EAA6E;IAC7E,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACnE,IAAI,CAAC,QAAQ,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,0DAA0D,CAAC,CAAC;QAC3G,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;QACzF,OAAO,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;IAClG,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtF,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,sBAAsB,QAAQ,gBAAgB,QAAQ,+CAA+C,CAAC,CAAC;QACnH,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,QAAQ,QAAQ,8FAA8F,CAAC,CAAC;QAC9H,CAAC;QACD,IAAI,SAAS,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,SAAS,iEAAiE,CAAC,CAAC;IACrH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;IAC9F,IAAI,aAAa;QAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,aAAa,EAAE,CAAC,CAAC;IAEnE,6EAA6E;IAC7E,KAAK,MAAM,IAAI,IAAI,IAAA,8BAAgB,EAAC,IAAA,4BAAc,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACvF,CAAC"}
|
package/dist/config.d.ts
CHANGED
|
@@ -50,6 +50,19 @@ export interface DiscoveryConfig {
|
|
|
50
50
|
sitemap?: boolean;
|
|
51
51
|
};
|
|
52
52
|
capture?: CaptureConfig;
|
|
53
|
+
/**
|
|
54
|
+
* Pages `coverage` must not report as a gap, as globs over the page name — the **same**
|
|
55
|
+
* dialect as `@ia-qa/self-healing`'s `volatile` and `nameMask`, so nobody learns a third.
|
|
56
|
+
*
|
|
57
|
+
* It exists because a gap list that never shrinks stops being read: thirty-three
|
|
58
|
+
* uncovered pages reported identically every week is alarm fatigue, and by the third run
|
|
59
|
+
* the map is noise. Declaring one closes the line.
|
|
60
|
+
*
|
|
61
|
+
* It is never a blindfold: a page matched here is **counted and named** as declared out
|
|
62
|
+
* of scope, never silently dropped, and nothing ever adds to this list on its own. A page
|
|
63
|
+
* leaves the gap because a person wrote it down in a file someone can review.
|
|
64
|
+
*/
|
|
65
|
+
outOfScope?: string[];
|
|
53
66
|
/**
|
|
54
67
|
* Optional BYOK config for . Its absence means the AI layer
|
|
55
68
|
* is inert and every deterministic verb behaves exactly as it does today.
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
import type { ExercisedRecord, TestDepthReport } from '@ia-qa/self-healing';
|
|
2
|
+
import type { PageCapture } from './capture/page';
|
|
3
|
+
import type { SurfaceManifest } from './scan';
|
|
4
|
+
/**
|
|
5
|
+
* What the suite tests, what the app has, and the gap — the one thing neither package can
|
|
6
|
+
* state alone. See SPEC-coverage-map.md.
|
|
7
|
+
*
|
|
8
|
+
* The rule that shapes every line below: **a declaration must never be readable as an
|
|
9
|
+
* observation.** A contract in `.ia-qa/mapping/` exists because somebody configured a page.
|
|
10
|
+
* `usage.json` proves a suite mentions a string. Only capture-during-run proves a test went
|
|
11
|
+
* somewhere, and only a scan proves a page exists. So this module refuses rather than
|
|
12
|
+
* substitutes: with no exercised record there is no coverage map, and the refusal names the
|
|
13
|
+
* command that would produce one.
|
|
14
|
+
*
|
|
15
|
+
* Nothing here emits a verdict. An uncovered page may be deliberately out of scope, which
|
|
16
|
+
* is a QA decision with a human's name on it — hence the scope declaration below, and hence
|
|
17
|
+
* no exit code above 0 for a gap.
|
|
18
|
+
*/
|
|
19
|
+
export declare const COVERAGE_SCHEMA = "ia-qa-coverage@1";
|
|
20
|
+
/** Where the healing artifacts live: sibling of `.ia-qa-discovery/`, never nested. */
|
|
21
|
+
export declare const HEALING_DIR = ".ia-qa";
|
|
22
|
+
export type RefusalReason = 'no-surface' | 'no-healing' | 'no-run';
|
|
23
|
+
export interface CoverageRefusal {
|
|
24
|
+
reason: RefusalReason;
|
|
25
|
+
/** Everything that IS available despite the refusal — stated precisely, never as "degraded". */
|
|
26
|
+
available: string[];
|
|
27
|
+
message: string;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* One page that exists and no test visits.
|
|
31
|
+
*
|
|
32
|
+
* `factors` is the ranking, and it is the output: a single weighted score would invite
|
|
33
|
+
* tuning and would hide that a page ranks high for a reason this user may consider
|
|
34
|
+
* irrelevant. Sorted by how many factors a page carries, ties broken by name so two runs
|
|
35
|
+
* agree.
|
|
36
|
+
*/
|
|
37
|
+
export interface UncoveredPage {
|
|
38
|
+
page: string;
|
|
39
|
+
url: string;
|
|
40
|
+
factors: string[];
|
|
41
|
+
fields: number;
|
|
42
|
+
passwordFields: number;
|
|
43
|
+
writeCalls: number;
|
|
44
|
+
apiCalls: number;
|
|
45
|
+
}
|
|
46
|
+
export interface CoverageMap {
|
|
47
|
+
schema: typeof COVERAGE_SCHEMA;
|
|
48
|
+
computedAt: string;
|
|
49
|
+
baseUrl: string;
|
|
50
|
+
/** Pages the suite loaded, observed by capture-during-run. */
|
|
51
|
+
visited: string[];
|
|
52
|
+
/** Pages found by the scan that no test visits, ranked. */
|
|
53
|
+
uncovered: UncoveredPage[];
|
|
54
|
+
/** Pages the human declared out of scope — counted and named, never silently dropped. */
|
|
55
|
+
outOfScope: string[];
|
|
56
|
+
/**
|
|
57
|
+
* Pages a contract is held for that this scan never reached. A limit of the scan (`--max`,
|
|
58
|
+
* crawl reach, session), never evidence a page is gone.
|
|
59
|
+
*/
|
|
60
|
+
contractedNotFound: string[];
|
|
61
|
+
/** What the scan could not see. Without it, a small gap reads as good news. */
|
|
62
|
+
notMeasured: SurfaceManifest['coverage'];
|
|
63
|
+
/** How much of each visited page's contract the suite names. */
|
|
64
|
+
depth: TestDepthReport;
|
|
65
|
+
suite: {
|
|
66
|
+
exitCode: number | null;
|
|
67
|
+
recordedAt: string;
|
|
68
|
+
commit?: string;
|
|
69
|
+
testCommand?: string;
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
export interface CoverageInput {
|
|
73
|
+
manifest: SurfaceManifest;
|
|
74
|
+
pages: PageCapture[];
|
|
75
|
+
exercised: ExercisedRecord;
|
|
76
|
+
depth: TestDepthReport;
|
|
77
|
+
scope?: string[];
|
|
78
|
+
baseUrl: string;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Why this page would hurt, from facts the scan observed.
|
|
82
|
+
*
|
|
83
|
+
* Deliberately short. Two factors the specification listed are **not** here because nothing
|
|
84
|
+
* on disk observes them today: inbound-link count (no page-level link graph is persisted)
|
|
85
|
+
* and prior drift (history records a run's verdict, not which page moved). Ranking on a
|
|
86
|
+
* number nobody measured is the failure this package keeps meeting; an absent factor stays
|
|
87
|
+
* absent.
|
|
88
|
+
*/
|
|
89
|
+
export declare function rankFactors(page: PageCapture): {
|
|
90
|
+
factors: string[];
|
|
91
|
+
passwordFields: number;
|
|
92
|
+
writeCalls: number;
|
|
93
|
+
};
|
|
94
|
+
/** Pages the human declared out of scope. One dialect: the same globs as `volatile`. */
|
|
95
|
+
export declare function matchesScope(page: string, scope: string[] | undefined): boolean;
|
|
96
|
+
export declare function buildCoverageMap(input: CoverageInput): CoverageMap;
|
|
97
|
+
/**
|
|
98
|
+
* The three refusals, each naming what remains true rather than calling the result
|
|
99
|
+
* "degraded". "Not computed" and "less accurate" are different claims, and only one of them
|
|
100
|
+
* is honest here.
|
|
101
|
+
*/
|
|
102
|
+
export declare function refusal(reason: RefusalReason): CoverageRefusal;
|
|
103
|
+
export interface LoadedSources {
|
|
104
|
+
manifest: SurfaceManifest;
|
|
105
|
+
pages: PageCapture[];
|
|
106
|
+
}
|
|
107
|
+
/** Read the scan's own capture. `null` when this project has never been scanned. */
|
|
108
|
+
export declare function loadSurface(captureDirPath: string): LoadedSources | null;
|
|
109
|
+
export type CoverageOutcome = {
|
|
110
|
+
ok: true;
|
|
111
|
+
map: CoverageMap;
|
|
112
|
+
} | {
|
|
113
|
+
ok: false;
|
|
114
|
+
refusal: CoverageRefusal;
|
|
115
|
+
};
|
|
116
|
+
/**
|
|
117
|
+
* Assemble the map from both packages' artifacts on this disk, or refuse.
|
|
118
|
+
*
|
|
119
|
+
* The order of the checks is the order of the user's own reasoning: is there an app capture,
|
|
120
|
+
* is a suite tracked at all, was it ever watched running.
|
|
121
|
+
*/
|
|
122
|
+
export declare function computeCoverage(opts: {
|
|
123
|
+
captureDirPath: string;
|
|
124
|
+
healingDirPath: string;
|
|
125
|
+
scope?: string[];
|
|
126
|
+
}): CoverageOutcome;
|