testilo 25.1.3 → 27.0.0

package/README.md

@@ -244,7 +244,7 @@ There are two ways to use the `script` module.
 
 ##### By a module
 
-A module can invoke `script` in this way:
+A module can invoke `script()` in this way:
 
 ```javaScript
 const {script} = require('testilo/script');
@@ -293,7 +293,7 @@ There are two ways to use the `merge` module.
 
 ##### By a module
 
-A module can invoke `merge` in this way:
+A module can invoke `merge()` in this way:
 
 ```javaScript
 const {merge} = require('testilo/merge');
@@ -426,7 +426,7 @@ Testilo can enhance such a report by:
 - creating difgests
 - creating comparisons
 
-## Scoring
+### Scoring
 
 To add scores to reports, the `score` module of Testilo performs computations on the test results and adds a `score` property to each report.
 
@@ -436,7 +436,7 @@ The `score()` function of the `score` module takes two arguments:
 
 A scoring function defines scoring rules. The Testilo package contains a `procs/score` directory, in which there are modules that export scoring functions. You can use one of those scoring functions, or you can create your own.
 
-### Scorers
+#### Scorers
 
 The built-in scoring functions are named `scorer()` and are exported by files whose names begin with `tsp` (for Testilo scoring proc). Those functions make use of `issues` objects defined in files whose names begin with `tic`. An `issues` object defines an issue classification: a body of data about rules of tools and the tool-agnostic issues that those rules are deemed to belong to.
 
@@ -482,11 +482,11 @@ The `quality` property is usually 1, but if the test of the rule is known to be
 
 Some issue objects (such as `flash` in `tic40.js`) have a `max` property, equal to the maximum possible count of instances. That property allows a scorer to ascribe a greater weight to an instance of that issue.
 
-### Invocation
+#### Invocation
 
 There are two ways to invoke the `score` module.
 
-#### By a module
+##### By a module
 
 A module can invoke `score()` in this way:
 
@@ -503,7 +503,7 @@ The second argument to `score()` is an array of report objects. They may have be
 
 The invoking module can further dispose of the scored reports as needed.
 
-#### By a user
+##### By a user
 
 A user can invoke `score()` in this way:
 
@@ -519,13 +519,13 @@ When a user invokes `score()` in this example, the `call` module:
 
 The optional third argument to `call()` (`75m` in this example) is a report selector. Without the argument, `call()` gets all the reports in the `raw` subdirectory. With the argument, `call()` gets only those reports whose names begin with the argument string.
 
-### Validation
+#### Validation
 
 To test the `score` module, in the project directory you can execute the statement `node validation/score/validate`. If `score` is valid, all logging statements will begin with “Success” and none will begin with “ERROR”.
 
-## Report digesting
+### Report digesting
 
-### Introduction
+#### Introduction
 
 Reports from Testaro are JavaScript objects. When represented as JSON, they are human-readable, but not human-friendly. They are basically designed for machine tractability. This is equally true for reports that have been scored by Testilo. But Testilo can _digest_ a scored report, converting it to a human-oriented HTML document, or _digest_.
 
@@ -538,11 +538,11 @@ The digesting function populates an HTML digest template. A copy of the template
 
 The included templates format placeholders with leading and trailing underscore pairs (such as `__issueCount__`).
 
-### Invocation
+#### Invocation
 
 There are two ways to use the `digest` module.
 
-#### By a module
+##### By a module
 
 A module can invoke `digest()` in this way:
 
@@ -564,7 +564,7 @@ The third argument is the absolute or relative URL of a directory where the repo
 
 The `digest()` function returns an array of digested reports. The invoking module can further dispose of the digested reports as needed.
 
-#### By a user
+##### By a user
 
 A user can invoke `digest()` in this way:
 
@@ -585,9 +585,9 @@ The optional fourth argument to `call()` (`75m` in this example) is a report sel
 
 The digests created by `digest()` are HTML files, and they expect a `style.css` file to exist in their directory. The `reports/digested/style.css` file in Testilo is an appropriate stylesheet to be copied into the directory where digested reports are written.
 
-## Report difgesting
+### Report difgesting
 
-### Introduction
+#### Introduction
 
 A _difgest_ is a digest that compares two reports. They can be reports of different targets, or reports of the same target from two different times or under two different conditions.
 
@@ -601,11 +601,11 @@ The `difgest` module difgests two scored reports. Its `difgest()` function takes
 
 The difgest template and module operate like the digest ones.
 
-### Invocation
+#### Invocation
 
 There are two ways to use the `difgest` module.
 
-#### By a module
+##### By a module
 
 A module can invoke `difgest()` in this way:
 
@@ -625,9 +625,9 @@ The difgest will include links to the two digests, which, in turn, contain links
 
 `difgest()` returns a difgest. The invoking module can further dispose of the difgest as needed.
 
-#### By a user
+##### By a user
 
-A user can invoke `difgest` in this way:
+A user can invoke `difgest()` in this way:
 
 ```bash
 node call difgest tfp99 20141215T1200-x7-3 20141215T1200-x7-4
@@ -642,7 +642,7 @@ Difgests include links to the digests of the two reports. The destinations of th
 
 Difgests expect a `style.css` file to exist in their directory, as digests do.
 
-### Validation
+#### Validation
 
 To test the `digest` module, in the project directory you can execute the statement `node validation/digest/validate`. If `digest` is valid, all logging statements will begin with “Success” and none will begin with “ERROR”.
 
@@ -656,13 +656,13 @@ The `compare` module compares the scores in a collection of scored reports. Its
 
 The comparison function defines the rules for generating an HTML file comparing the scored reports. The Testilo package contains a `procs/compare` directory, in which there are subdirectories containing modules that export comparison functions. You can use one of those functions, or you can create your own.
 
-### Invocation
+#### Invocation
 
 There are two ways to use the `compare` module.
 
-#### By a module
+##### By a module
 
-A module can invoke `compare` in this way:
+A module can invoke `compare()` in this way:
 
 ```javaScript
 const {compare} = require('testilo/compare');
@@ -674,9 +674,9 @@ compare(comparer, scoredReports)
 
 The first argument to `compare()` is a comparison function. In this example, it been obtained from a file in the Testilo package, but it could be custom-made. The second argument to `compare()` is an array of report objects. The `compare()` function returns a comparative report. The invoking module can further dispose of the comparative report as needed.
 
-#### By a user
+##### By a user
 
-A user can invoke `compare` in this way:
+A user can invoke `compare()` in this way:
 
 ```bash
 node call compare tcp99 legislators
@@ -690,6 +690,10 @@ When a user invokes `compare` in this example, the `call` module:
 
 The comparative report created by `compare` is an HTML file, and it expects a `style.css` file to exist in its directory. The `reports/comparative/style.css` file in Testilo is an appropriate stylesheet to be copied into the directory where comparative reports are written.
 
+#### Validation
+
+To test the `compare` module, in the project directory you can execute the statement `node validation/compare/validate`. If `compare` is valid, all logging statements will begin with “Success” and none will begin with “ERROR”.
+
 ### Tool crediting
 
 If you use Testaro to perform all the tests of all the tools on multiple targets and score the reports with a score proc that maps tool rules onto tool-agnostic issues, you may want to tabulate the comparative efficacy of each tool in discovering instances of issues. Testilo can help you do this by producing a _credit report_.
@@ -704,13 +708,13 @@ The credit report contains four sections:
     - `onlies`: a list of the issues that only the tool reported instances of
     - `mosts`: a list of the issues for which the instance count of the tool was not surpassed by that of any other tool
 
-### Invocation
+#### Invocation
 
 There are two ways to use the `credit` module.
 
-#### By a module
+##### By a module
 
-A module can invoke `credit` in this way:
+A module can invoke `credit()` in this way:
 
 ```javaScript
 const {credit} = require('testilo/credit');
@@ -720,9 +724,9 @@ credit(scoredReports)
 
 The argument to `credit()` is an array of scored report objects. The `credit()` function returns a credit report. The invoking module can further dispose of the credit report as needed.
 
-#### By a user
+##### By a user
 
-A user can invoke `credit` in this way:
+A user can invoke `credit()` in this way:
 
 ```bash
 node call credit legislators 23pl
@@ -734,9 +738,73 @@ When a user invokes `credit` in this example, the `call` module:
 
 The third argument to `call` (`23pl` in this example) is optional. If it is omitted, `call` will get and `credit()` will tabulate all the reports in the `scored` directory.
 
-### Validation
+### Summarization
 
-To test the `compare` module, in the project directory you can execute the statement `node validation/compare/validate`. If `compare` is valid, all logging statements will begin with “Success” and none will begin with “ERROR”.
+The `summarize` module of Testilo can summarize a collection of scored reports. The summary of each report contains, insofar as they exist in the report, its ID, end time, order ID, target data, and total score.
+
+#### Invocation
+
+##### By a module
+
+A module can invoke `summarize()` in this way:
+
+```javaScript
+const {summarize} = require('testilo/summarize');
+const reports = […];
+const summary = summarize(reports);
+…
+```
+
+The `reports` argument is an array of scored reports. The `summary` constant is an object. The module can further dispose of `summary` as needed.
+
+##### By a user
+
+A user can invoke `summarize()` in either of these two ways:
+
+```javaScript
+node call summarize divisions
+node call summarize divisions 2411
+```
+
+When a user invokes `summarize` in this example, the `call` module:
+- gets all the reports in the `scored` subdirectory of the `REPORTDIR` directory, or (if the third argument is present) all those whose file names begin with `2411`.
+- writes the summary, with `divisions` as its description, in JSON format to the `summarized` subdirectory of the `REPORTDIR` directory.
+
+### Track
+
+The `track` module of Testilo selects, organizes, and presents data from summaries to show changes over time in total scores. The module produces a web page, showing changes in a table and (in the future) also in a line graph.
+
+#### Invocation
+
+##### By a module
+
+A module can invoke `track()` in this way:
+
+```javaScript
+const {track} = require('testilo/track');
+const trackerDir = `${process.env.FUNCTIONDIR}/track/ttp99a`;
+const {tracker} = require(`${trackerDir}/index`);
+const summary = …;
+const [reportID, trackReport] = track(tracker, summary);
+```
+
+The `track()` function returns an ID and an HTML tracking report that shows data for all of the results in the summary. The invoking module can further dispose of the report as needed.
+
+##### By a user
+
+A user can invoke `track()` in this way:
+
+```javaScript
+node call track ttp99a 241016T2045-Uf-0 4 'ABC Foundation'
+```
+
+When a user invokes `track()` in this example, the `call` module:
+- gets the summary from the `241016T2045-Uf-0.json` file in the `summarized` subdirectory of the `REPORTDIR` directory.
+- selects the summarized data for all audits with the `order` value of `'4'` and the `target.what` value of `'ABC Foundation'`. If the third or fourth argument to `call()` is `null` (or omitted), then `call()` does not select audits by `order` or by `target.what`, respectively.
+- uses tracker `ttp99a` to create a tracking report.
+- writes the tracking report to the `tracking` subdirectory of the `REPORTDIR` directory.
+
+The tracking reports created by `track()` are HTML files, and they expect a `style.css` file to exist in their directory. The `reports/tracking/style.css` file in Testilo is an appropriate stylesheet to be copied into the directory where tracking reports are written.
 
 ## Origin
 

package/call.js

@@ -34,6 +34,10 @@ const {digest} = require('./digest');
 const {difgest} = require('./difgest');
 // Function to compare scores.
 const {compare} = require('./compare');
+// Function to summarize reports.
+const {summarize} = require('./summarize');
+// Function to track audits.
+const {track} = require('./track');
 
 // ########## CONSTANTS
 
@@ -151,8 +155,7 @@ const callDigest = async (digesterID, selector = '') => {
   // If any exist:
   if (reports.length) {
     // Get the digester.
-    const digesterDir = `${functionDir}/digest/${digesterID}`;
-    const {digester} = require(`${digesterDir}/index`);
+    const {digester} = require(`${functionDir}/digest/${digesterID}/index`);
     // Digest the reports.
     const digestedReports = await digest(digester, reports);
     const digestedReportDir = `${reportDir}/digested`;
@@ -170,7 +173,7 @@ const callDigest = async (digesterID, selector = '') => {
     console.log('ERROR: No scored reports to be digested');
   }
 };
-// Fulfills a digesting request.
+// Fulfills a difgesting request.
 const callDifgest = async (difgesterID, reportAID, reportBID) => {
   // Get the scored reports to be difgested.
   const reportAArray = await getReports('scored', reportAID);
@@ -230,7 +233,7 @@ const callCredit = async (tallyID, selector = '') => {
     const creditDir = `${reportDir}/credit`;
     await fs.mkdir(creditDir, {recursive: true}); 
     await fs.writeFile(`${creditDir}/${tallyID}.json`, JSON.stringify(tally, null, 2));
-    console.log(`Reports tallied and credit report saved in ${creditDir}`);
+    console.log(`Reports tallied and credit report ${tallyID} saved in ${creditDir}`);
   }
   // Otherwise, i.e. if no scored reports are to be tallied:
   else {
@@ -238,6 +241,68 @@ const callCredit = async (tallyID, selector = '') => {
     console.log('ERROR: No scored reports to be tallied');
   }
 };
+// Fulfills a summarization request.
+const callSummarize = async (what, selector = '') => {
+  // Get the scored reports to be summarized.
+  const reports = await getReports('scored', selector);
+  // If any exist:
+  if (reports.length) {
+    // Summarize them.
+    const summary = summarize(what, reports);
+    // Add the selector, if any, to the summary.
+    if (selector) {
+      summary.selector = selector;
+    }
+    // Save the summary.
+    const summaryDir = `${reportDir}/summarized`;
+    await fs.mkdir(summaryDir, {recursive: true}); 
+    const filePath = `${summaryDir}/${summary.id}.json`;
+    await fs.writeFile(filePath, `${JSON.stringify(summary, null, 2)}\n`);
+    console.log(`Reports summarized and summary saved as ${filePath}`);
+  }
+  // Otherwise, i.e. if no scored reports are to be summarized:
+  else {
+    // Report this.
+    console.log('ERROR: No scored reports to be summarized');
+  }
+};
+// Fulfills a tracking request.
+const callTrack = async (trackerID, summaryID, orderID, targetWhat) => {
+  // Get the summary.
+  try {
+    const summaryJSON = await fs.readFile(`${reportDir}/summarized/${summaryID}.json`, 'utf8');
+    const summary = JSON.parse(summaryJSON);
+    // Remove unwanted audits from it.
+    summary.data = summary.data.filter(audit => {
+      if (orderID && audit.order !== orderID) {
+        return false;
+      }
+      if (targetWhat && audit.target && audit.target.what !== targetWhat) {
+        return false;
+      }
+      return true;
+    });
+    // If any audits remain:
+    if (summary.data.length) {
+      // Get the tracker.
+      const {tracker} = require(`${functionDir}/track/${trackerID}/index`);
+      // Track the audits.
+      const [reportID, trackingReport] = await track(tracker, summary);
+      // Save the tracking report.
+      await fs.mkdir(`${reportDir}/tracking`, {recursive: true});
+      const reportPath = `${reportDir}/tracking/${reportID}.html`;
+      await fs.writeFile(reportPath, trackingReport);
+      console.log(`Tracking report saved in ${reportPath}`);
+    }
+    // Otherwise, i.e. if no audits remain:
+    else {
+      console.log('ERROR: No audits match the request');
+    }
+  }
+  catch(error) {
+    console.log(`ERROR: Tracking request invalid (${error.message})`);
+  }
+};
 
 // ########## OPERATION
 
@@ -296,6 +361,18 @@ else if (fn === 'credit' && fnArgs.length > 0 && fnArgs.length < 3) {
     console.log('Execution completed');
   });
 }
+else if (fn === 'summarize' && fnArgs.length > 0 && fnArgs.length < 3) {
+  callSummarize(... fnArgs)
+  .then(() => {
+    console.log('Execution completed');
+  });
+}
+else if (fn === 'track' && fnArgs.length > 1 && fnArgs.length < 5) {
+  callTrack(... fnArgs)
+  .then(() => {
+    console.log('Execution completed');
+  });
+}
 else {
   console.log('ERROR: Invalid statement');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testilo",
-  "version": "25.1.3",
+  "version": "27.0.0",
   "description": "Prepares and processes Testaro reports",
   "main": "call.js",
   "scripts": {

package/procs/compare/tcp40/index.js

@@ -7,7 +7,7 @@
 
 // Module to access files.
 const fs = require('fs/promises');
-const {getBarCell} = require('../../util');
+const {getBarCell, getNowDate, getNowDateSlash} = require('../../util');
 
 // CONSTANTS
 
@@ -63,9 +63,8 @@ const populateQuery = async (scoredReports, query) => {
   const data = await getData(scoredReports);
   query.pageCount = data.pageCount;
   query.tableBody = await getTableBody(data.bodyData);
-  const date = new Date();
-  query.dateISO = date.toISOString().slice(0, 10);
-  query.dateSlash = query.dateISO.replace(/-/g, '/');
+  query.dateISO = getNowDate();
+  query.dateSlash = getNowDateSlash();
 };
 // Returns a comparative report.
 exports.comparer = async scoredReports => {

package/procs/difgest/tfp40/index.js

@@ -9,7 +9,7 @@ const {issues} = require('../../score/tic40');
 // Module to process files.
 const fs = require('fs/promises');
 // Utility module.
-const {getBarCell} = require('../../util');
+const {getBarCell, getNowDate, getNowDateSlash} = require('../../util');
 
 // CONSTANTS
 
@@ -46,8 +46,8 @@ const getIssueScoreRow = (summary, wcag, scoreA, scoreB, aSuperiorityMax, bSuper
 const populateQuery = (reportA, reportB, query) => {
   // General parameters.
   query.fp = id;
-  query.dateISO = new Date().toISOString().slice(0, 10);
-  query.dateSlash = query.dateISO.replace(/-/g, '/');
+  query.dateISO = getNowDate();
+  query.dateSlash = getNowDateSlash();
   // For each report:
   const issueIDs = new Set();
   [reportA, reportB].forEach((report, index) => {

package/procs/digest/tdp40/index.js

@@ -8,6 +8,8 @@ require('dotenv').config();
 const {issues} = require('../../score/tic40');
 // Module to process files.
 const fs = require('fs/promises');
+// Utility module.
+const {getNowDate, getNowDateSlash} = require('../../util');
 
 // CONSTANTS
 
@@ -34,8 +36,8 @@ const populateQuery = (report, query) => {
   query.sp = scoreProcID;
   query.dp = digesterID;
   // Add the job data to the query.
-  query.dateISO = jobData.endTime.slice(0, 8);
-  query.dateSlash = query.dateISO.replace(/-/g, '/');
+  query.dateISO = getNowDate();
+  query.dateSlash = getNowDateSlash();
   query.org = target.what;
   query.url = target.which;
   query.requester = requester;

package/procs/track/ttp40/index.html

@@ -0,0 +1,42 @@
+<!DOCTYPE HTML>
+<html lang="en-US">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="author" content="Testilo">
+    <meta name="creator" content="Testilo">
+    <meta name="publisher" name="Testilo">
+    <meta name="description" content="report of accessibility testing of web pages">
+    <meta name="keywords" content="accessibility a11y web testing">
+    <title>Accessibility tracking report</title>
+    <link rel="icon" href="favicon.ico">
+    <link rel="stylesheet" href="style.css">
+  </head>
+  <body>
+    <main>
+      <header>
+        <h1>Accessibility tracking report</h1>
+        <h2>Introduction</h2>
+        <p>This is tracking report <code>__id__</code>.</p>
+        <p>It tracks accessibility scores over time. A perfect score is 0. The tracking was performed by procedure __tp__.</p>
+      </header>
+      <table class="allBorder secondCellRight thirdCellRight">
+        <caption>Accessibility scores</caption>
+        <thead>
+          <tr>
+            <th>Date and time</th>
+            <th>Score</th>
+            <th>Order</th>
+            <th>Target</th>
+          </tr>
+        </thead>
+        <tbody>
+          __scoreRows__
+        </tbody>
+      </table>
+      <footer>
+        <p class="date">Produced <time itemprop="datePublished" datetime="__dateISO__">__dateSlash__</time></p>
+      </footer>
+    </main>
+  </body>
+</html>

package/procs/track/ttp40/index.js

@@ -0,0 +1,63 @@
+// index: tracker for tracking procedure ttp40.
+
+// IMPORTS
+
+// Module to keep secrets.
+require('dotenv').config();
+// Module to process files.
+const fs = require('fs/promises');
+// Utility module.
+const {alphaNumOf, getNowDate, getNowDateSlash} = require('../../util');
+
+// CONSTANTS
+
+// Tracker ID.
+const trackerID = 'ttp40';
+// Newline with indentations.
+const innerJoiner = '\n          ';
+// Digest URL.
+const digestURL = process.env.DIGEST_URL;
+
+// FUNCTIONS
+
+// Adds parameters to a query for a tracking report.
+const populateQuery = (id, summary, query) => {
+  // General parameters.
+  query.id = id;
+  query.tp = trackerID;
+  query.dateISO = getNowDate();
+  query.dateSlash = getNowDateSlash();
+  // For each score:
+  const rows = [];
+  const results = summary.data;
+  const targetWhats = Array.from(new Set(results.map(result => result.target.what))).sort();
+  summary.data.forEach(result => {
+    // Create an HTML table row for it.
+    const timeCell = `<td>${result.endTime}</td>`;
+    const digestLinkDestination = digestURL.replace('__id__', result.id);
+    const scoreCell = `<td><a href=${digestLinkDestination}>${result.score}</a></td>`;
+    const orderCell = `<td class="center">${result.order}</td>`;
+    const targetID = alphaNumOf(targetWhats.indexOf(result.target.what));
+    const targetLink = `<a href="${result.target.which}">${result.target.what}</a>`;
+    const targetCell = `<td>${targetID}: ${targetLink}</td>`;
+    const row = `<tr>${[timeCell, scoreCell, orderCell, targetCell].join('')}</tr>`;
+    // Add the row to the array of rows.
+    rows.push(row);
+  });
+  // Add the rows to the query.
+  query.scoreRows = rows.join(innerJoiner);
+};
+// Returns a tracking report.
+exports.tracker = async (id, summary) => {
+  // Create a query to replace placeholders.
+  const query = {};
+  populateQuery(id, summary, query);
+  // Get the template.
+  let template = await fs.readFile(`${__dirname}/index.html`, 'utf8');
+  // Replace its placeholders.
+  Object.keys(query).forEach(param => {
+    template = template.replace(new RegExp(`__${param}__`, 'g'), query[param]);
+  });
+  // Return the tracking report.
+  return template;
+};

package/procs/util.js

@@ -18,13 +18,17 @@ const alphaNumChars = (() => {
 // Returns a string representing a date and time.
 const getTimeString = date => date.toISOString().slice(0, 19);
 // Returns a string representing the date and time.
-exports.getNowString = () => getTimeString(new Date());
+const getNowString = exports.getNowString = () => getTimeString(new Date());
+// Returns a string representing an ISO date.
+const getNowDate = exports.getNowDate = () => getNowString().slice(0, 10);
+// Returns a string representing a date with slashes.
+exports.getNowDateSlash = () => getNowDate().replace(/-/g, '/');
 // Returns a time stamp representing a date and time.
 const getTimeStamp
 = exports.getTimeStamp
 = date => getTimeString(date).replace(/[-:]/g, '').slice(2, 13);
 // Returns a time stamp representing the date and time.
-exports.getNowStamp = () => getTimeStamp(new Date());
+const getNowStamp = exports.getNowStamp = () => getTimeStamp(new Date());
 // Inserts a character periodically in a string.
 const punctuate = (string, insertion, chunkSize) => {
   const segments = [];
@@ -56,13 +60,19 @@ exports.alphaNumOf = num => {
   return resultDigits.join('');
 };
 // Returns a random string.
-exports.getRandomString = length => {
+const getRandomString = exports.getRandomString = length => {
   const chars = [];
   for (let i = 0; i < length; i++) {
     chars.push(alphaNumChars[Math.floor(62 * Math.random())]);
   }
   return chars.join('');
 };
+// Returns a file ID.
+exports.getFileID = randomLength => {
+  const timePart = getNowStamp();
+  const randomPart = getRandomString(randomLength);
+  return `${timePart}-${randomPart}-0`;
+};
 // Returns a horizontal SVG graph bar.
 const getSVGBar = (num, max, isRight) => {
   const widthFrac = 100 * num / max;

package/reports/tracking/style.css

@@ -0,0 +1,115 @@
+*:focus {
+  outline: solid 0.2rem #00f;
+  outline-offset: 0.2rem;
+}
+body {
+  margin: 2rem;
+  font-size: large;
+}
+.bold, .componentID {
+  font-weight: 700;
+}
+button {
+  min-height: 44px;
+  min-width: 44px;
+  padding: 0.5rem;
+  border: solid 0.2rem #03a;
+  border-radius: 1rem;
+  font-size: inherit;
+  font-weight: 700;
+  color: #fff;
+  background-color: #03a;
+}
+button:hover {
+  color: #000;
+  background-color: #9df;
+}
+caption {
+  margin: 1rem 0;
+  font-weight: 700;
+  font-style: italic;
+}
+code {
+  font-family: sans-serif;
+  color: #832703;
+}
+.error {
+  font-weight: 700;
+  color: #c00;
+}
+fieldset {
+  width: max-content;
+  margin-top: 1rem;
+}
+.firstCellRight td:nth-child(1) {
+  text-align: right;
+}
+form {
+  margin-top: 1rem;
+}
+h1, h2, h3, h4, h5, h6 {
+  margin-bottom: 0;
+}
+h2 {
+  font-size: 1.8rem;
+  margin: 1rem auto 0.5rem auto;
+  color: #006666;
+}
+h3 {
+  font-size: 1.6rem;
+}
+h3.bars {
+  border-top: solid black 0.1rem;
+  padding-top: 0.3rem;
+}
+h4 {
+  font-size: 1.4rem;
+}
+h5 {
+  font-size: 1.2rem;
+}
+h6 {
+  font-size: 1rem;
+}
+input {
+  margin: 0.5rem 0;
+  font-size: inherit;
+}
+legend {
+  font-weight: 700;
+}
+pre {
+  white-space: break-spaces;
+}
+.secondCellRight td:nth-child(2) {
+  text-align: right;
+}
+section:not(.wide) {
+  max-width: 36rem;
+}
+#synopsis > p {
+  margin: 0;
+  padding: 0;
+}
+table {
+  border-collapse: collapse;
+}
+table.allBorder th {
+  padding-bottom: 0;
+}
+table.allBorder th, table.allBorder td, tbody td {
+  border: 1px gray solid;
+}
+tbody th {
+  padding-right: 1rem;
+  text-align: right;
+}
+td, th {
+  padding: 0 0.5rem;
+}
+thead th {
+  padding-bottom: 1rem;
+}
+.thirdCellRight td:nth-child(3) {
+  text-align: right;
+}

package/summarize.js

@@ -0,0 +1,35 @@
+/*
+  summarize.js
+  Returns a summary of reports.
+*/
+
+// ########## IMPORTS
+
+// Module to keep secrets.
+require('dotenv').config();
+// Module to perform common operations.
+const {getFileID} = require('./procs/util');
+
+// ########## FUNCTIONS
+
+// Returns a summary.
+exports.summarize = (what, reports) => {
+  const data = reports.map(report => {
+    const {id, jobData, score, sources} = report;
+    const order = sources && sources.order || '';
+    const target = sources && sources.target || '';
+    return {
+      id: id || '',
+      endTime: jobData && jobData.endTime || '',
+      order: order || '',
+      target,
+      score: score && score.summary && score.summary.total || null
+    };
+  });
+  const summary = {
+    id: getFileID(2),
+    what,
+    data
+  };
+  return summary;
+};

package/track.js

@@ -0,0 +1,23 @@
+/*
+  track.js
+  Creates tracking reports from report summaries.
+  Arguments:
+    0. Tracking function.
+    1. Summary.
+*/
+
+// ########## IMPORTS
+
+// Module to perform common operations.
+const {getFileID} = require('./procs/util');
+
+// ########## FUNCTIONS
+
+// Creates and returns a tracking report from a summary.
+exports.track = async (tracker, summary) => {
+  // Use the tracker to create a tracking report.
+  const id = getFileID(2);
+  const trackingReport = await tracker(id, summary);
+  console.log(`Tracking report ${id} created`);
+  return [id, trackingReport];
+};