@descent-vtt/spec-brief 0.6.1 → 0.8.0

package/CHANGELOG.md

@@ -11,6 +11,114 @@ release that can turn a run red. This is the family's policy, recorded in
 releases up to 0.2.7 came before it, and several of their patches changed
 what a run reports.
 
+## 0.8.0
+
+An option is refused, exit 2, where taking it would tell someone what is
+not so: `init --strict`, `init --config`, `--color` on a command that
+prints none, and `--config` beside `--no-config`. Each ran as the line
+without it does. An option that asks a command to leave out what it never
+does is still taken. And `FORCE_COLOR=false` turns colour off.
+
+### Changed
+
+- **An option is refused where taking it would tell someone what is not
+  so.** `init` with `--config`, `--strict` or `--color`, `new` with
+  `--strict` or `--color`, and `list --strict` each ran as the line without
+  the option does, exit 0: `init --config team.json` wrote
+  `.spec-brief.json`, and `init --strict` set nothing up strictly. Each is
+  now exit 2 with a line that names the command, the option and what the
+  command reads, and writes nothing. An option that asks a command to
+  leave out what it never does is still taken, since it asks for what is
+  already so: `--no-color` by every command, and `--no-git` and
+  `--no-config` by `init` (ADR-0001,
+  [An option a command does not read](README.md#an-option-a-command-does-not-read)).
+  Upgrading: drop the option from that command's line; `init` writes
+  `.spec-brief.json` and no other file, so a configuration kept under
+  another name is renamed after it.
+- **`--config` beside `--no-config`, and `--color` beside `--no-color`, are
+  refused.** The defaults ran with the file never opened, and colour was
+  off whatever `--color` asked, with no word of either; each pair is now
+  exit 2 with a line that names both. Upgrading: give one of the two.
+
+### Fixed
+
+- **`FORCE_COLOR=false` turns colour off**, as `FORCE_COLOR=0` does, on a
+  terminal too. It forced colour on, into a pipe as well, where Node itself
+  and `supports-color` read it as off. Any other value that is not empty
+  still forces colour on, and `NO_COLOR`, `--color` and `--no-color` win as
+  they did.
+
+## 0.7.0
+
+An input that is set and names nothing is refused, exit 2, by a line that
+names it, where it was read as if it had not been given: a
+`SOURCE_DATE_EPOCH` that is no date, an option given an empty value, an
+argument a command does not take, a `--root` that is no directory, a list
+that names no brief or has a place that names none.
+
+### Changed
+
+- **A `SOURCE_DATE_EPOCH` that is set and cannot be read as a date is
+  refused, not read as unset.** `new` and `archive` without `--date` took
+  `tomorrow`, `1.5`, `-1`, a value with a space beside its digits and an
+  empty one for no value at all, wrote the clock's date and exited 0. Each
+  now writes nothing and ends with exit 2 and a line that names the variable
+  and shows what it holds, and `today()` from the package throws for them
+  (ADR-0004, [Today's date](README.md#todays-date)).
+  Upgrading: set it to whole seconds in digits alone, as `date +%s` prints
+  them, no more than `253402300799` (9999-12-31), or pass `--date`, or leave
+  it unset; set and empty is not unset.
+- **An option given an empty value is refused by its name, not read as the
+  option left out.** `new "T" --id ""` wrote `briefs/_t.md`, a file no
+  command reads again; `--root ""` ran in the current directory; `archive
+  --summary ""` wrote a banner without the sentence; `init --briefs " "`
+  made a directory named with a space. Every option that takes a value now
+  ends the run with exit 2 and `--id is "", which is no value` for one that
+  is empty or only space, nothing written; the ones refused already say the
+  same line (ADR-0001, [An input that names nothing](README.md#an-input-that-names-nothing)).
+  Upgrading: where a script may hand an option nothing, leave the option
+  out, as `${ID:+--id "$ID"}` does in a shell.
+- **`new --depends-on` refuses a list that names no brief, and a place in
+  one that names none.** `--depends-on ,` scaffolded a brief with no
+  dependency, and `7,8,` or `7,,8` one that depends on 7 and 8, as `"$A,$B"`
+  with `$B` unset made one that depends on `$A` alone, each exit 0.
+  Upgrading: leave the option out for a brief that depends on nothing, and
+  write the list with one comma between each two ids and none at either end.
+- **`init`, `list`, `matrix` and `schedule` refuse an argument, which they
+  do not take.** `list nonsense` listed every brief, `schedule later
+  --write` ran as `schedule --write`, and `init mydir` set up the current
+  directory, each exit 0; each is now exit 2 with the argument named and the
+  command's usage. Upgrading: drop the argument; `init --root mydir` sets up another
+  directory, and `--briefs mydir` names the one for the briefs.
+- **A `--root` that is no directory is refused.** Given a file or a path
+  that does not exist, the search for a configuration went on from its
+  parent: `lint --root tpyo` linted the tree above, and `new --root tpyo`
+  wrote into it, exit 0. `init` still makes a root that is not there.
+  Upgrading: give `--root` a directory that exists.
+
+### Fixed
+
+- A terminal that says `TERM=dumb` gets no colour, unless `FORCE_COLOR` or
+  `--color` asks for it, as the family's other tools have it. It was sent
+  the escape sequences it had said it does not read.
+- A `SOURCE_DATE_EPOCH` that cannot be read stops only a run that would
+  write its date. One of more seconds than any date has ended `lint`,
+  `list`, `matrix`, `schedule`, `init` and `unarchive`, and `new` and
+  `archive` given `--date`, with exit 2; they now run whatever it holds.
+- A `SOURCE_DATE_EPOCH` in the years 10000 to 275760 is refused by name,
+  where `new` and `archive` said `"+010000-01" is not a date written
+  YYYY-MM-DD`. Exit 2, as before.
+- The README says what `SOURCE_DATE_EPOCH` does, and `--help` names it
+  beside `--date`.
+- A configuration that is a directory, named by `--config` or found as
+  `.spec-brief.json`, is said in one line, `adir: is a directory, not a
+  configuration file`, where the run ended on `unexpected error: Error:
+  EISDIR` and a stack. Exit 2, as before.
+- A configuration that is not JSON is refused in one line whatever the file
+  holds. A line break the parser quoted from it made the refusal two lines,
+  and any other control character reached the terminal as it was; each is
+  now written as its escape. Exit 2, as before.
+
 ## 0.6.1
 
 Four ways a run ended with `unexpected error:` and a stack for something

package/README.md

@@ -95,11 +95,11 @@ A brief is read as CommonMark reads it wherever that decides what is code or a c
 
 ### `spec-brief init`
 
-Writes `.spec-brief.json` with every default spelled out, and creates the brief and archive directories. `--briefs <dir>` and `--archive <dir>` choose them.
+Writes `.spec-brief.json` with every default spelled out, and creates the brief and archive directories. `--briefs <dir>` and `--archive <dir>` choose them, and `--root <dir>` the directory to set up, which `init` makes when it is not there. It takes no argument: `init mydir` is [refused](#an-input-that-names-nothing).
 
 ### `spec-brief new <title>`
 
-Scaffolds a brief with the next free number - one more than the highest id, live or archived, since ids are never reused - and every required section, each holding its `hint` in a comment. A comment is not content, so a fresh brief reads as unwritten until someone writes it. `--id`, `--type`, `--wave`, `--depends-on 7,8` and `--date` fill the front matter.
+Scaffolds a brief with the next free number - one more than the highest id, live or archived, since ids are never reused - and every required section, each holding its `hint` in a comment. A comment is not content, so a fresh brief reads as unwritten until someone writes it. `--id`, `--type`, `--wave`, `--depends-on 7,8` and `--date` fill the front matter; without `--date` the date is [today's](#todays-date).
 
 ### `spec-brief lint [brief...]`
 
@@ -230,6 +230,7 @@ With `archiving.rewriteLinks` off, no link is rewritten, and the links other liv
 | `--base <rev>` | Measures from the merge base instead, for a branch of several commits. |
 | `--pr <n>` | Links the pull request. |
 | `--summary <text>` | What the round did, in the banner. |
+| `--date <YYYY-MM-DD>` | The date in the banner, where it is not [today's](#todays-date). |
 | `--dry-run` | Prints the plan and the banner, and writes nothing. |
 
 spec-brief reads git and never writes it. Review the change and commit it with the round.
@@ -245,16 +246,21 @@ Reopens an archived brief: the banner and the hash come off, the status goes bac
 
 ### Every command
 
-| Flag | What it does |
-| --- | --- |
-| `--root <dir>` | Runs from another directory. |
-| `--config <file>` | Names the configuration. |
-| `--no-config` | Uses the defaults. |
-| `--format <format>` | `pretty` by default, or `json`; `lint`, `matrix` and `schedule`, which report findings, also write `sarif`, `github` and `gitlab`, and `--help` lists each command's formats. |
-| `--strict` | Makes warnings fail the run. |
-| `--no-git` | Leaves git out even inside a repository: the tree is read from disk, and `archive` records no commit. |
-| `--color`, `--no-color` | Override `NO_COLOR`, `FORCE_COLOR` and the terminal check. |
-| `--help`, `--version` | Do what they say. |
+Every command takes these, except where the last column names it: an option is [refused where taking it would tell someone what is not so](#an-option-a-command-does-not-read).
+
+| Flag | What it does | Not for |
+| --- | --- | --- |
+| `--root <dir>` | Runs from another directory, which must be there: only `init` makes one that is not. | |
+| `--config <file>` | Names the configuration. | `init`, which writes `.spec-brief.json` |
+| `--no-config` | Uses the defaults. | |
+| `--format <format>` | `pretty` by default, or `json`; `lint`, `matrix` and `schedule`, which report findings, also write `sarif`, `github` and `gitlab`, and `--help` lists each command's formats. | |
+| `--strict` | Makes warnings fail the run. | `init`, `new` and `list`, which have none |
+| `--no-git` | Leaves git out even inside a repository: the tree is read from disk, and `archive` records no commit. | |
+| `--color` | Colour, whatever the environment and the terminal say. | `init` and `new`, which print none |
+| `--no-color` | No colour, whatever they say. | |
+| `--help`, `--version` | Do what they say, whatever else is on the line. | |
+
+Without `--color` or `--no-color`, `NO_COLOR` set to anything turns colour off; otherwise `FORCE_COLOR` turns it on, and `FORCE_COLOR=0` or `FORCE_COLOR=false` off, on a terminal too; otherwise `TERM=dumb` turns it off; otherwise a terminal has colour and a pipe has none. `NO_COLOR` or `FORCE_COLOR` set to nothing is as unset. Only the `pretty` format has colour.
 
 **Exit codes:**
 
@@ -262,10 +268,47 @@ Reopens an archived brief: the banner and the hash come off, the status goes bac
 | --- | --- |
 | `0` | Clean. |
 | `1` | Findings, a collision, or a refused action. |
-| `2` | The run could not be trusted, or its answer did not arrive - a bad flag, a configuration that does not load, a brief that does not exist, a git command that failed, a `SOURCE_DATE_EPOCH` no date can be made of, a stdout its reader closed before all of the output was written, as a pipeline into `head` does, each said in one line on stderr, or an error spec-brief did not expect, reported on stderr as `spec-brief: unexpected error:` with its stack. |
+| `2` | The run could not be trusted, or its answer did not arrive - a bad flag, [an input that names nothing](#an-input-that-names-nothing), [an option the command does not read](#an-option-a-command-does-not-read), a configuration that does not load, a brief that does not exist, a git command that failed, a `SOURCE_DATE_EPOCH` that [cannot be read as a date](#todays-date) where one is to be written, a stdout its reader closed before all of the output was written, as a pipeline into `head` does, each said in one line on stderr, or an error spec-brief did not expect, reported on stderr as `spec-brief: unexpected error:` with its stack. |
 
 A run over a briefs directory that does not exist exits 2, because a check over nothing looks exactly like a clean one.
 
+### An input that names nothing
+
+An option, an argument or a path that is given and names nothing is refused: exit 2, one line that names it, nothing written. None is read as if it had not been given. `--root "$DIR"` where the variable is not set would otherwise run in the current directory, and the answer would look like the one that was asked for.
+
+- **An option given nothing.** Every option that takes a value refuses one that is empty or only space, by the option's name: `--id is "", which is no value`. No option gives an empty value a meaning; leave the option out for what it does by default.
+- **A list that names nothing.** `--depends-on ,` names no brief, and a brief that depends on nothing is one scaffolded without the option. A place in a list that names no brief, the comma too many in `7,8,` or the gap in `7,,8`, is refused as well: it is a brief left out, as `"$A,$B"` is with one of the two unset.
+- **An argument a command does not take.** `init`, `list`, `matrix` and `schedule` take none and refuse one by name, with their usage. `init mydir` set up the current directory; `init --root mydir` is what sets up another.
+- **A `--root` that is no directory.** A file, or a path that does not exist, is refused: the search for a configuration would go on from its parent, and the run would report on, or `new` write into, the tree above. A directory below the configuration's is a place to start from, as the current directory is.
+- **A configuration that is a directory**, named by `--config` or found under the configuration's name, does not load, and is said so in a line, as one that is not JSON is.
+
+### An option a command does not read
+
+An option is refused where taking it would tell someone what is not so: exit 2, one line that names the command, the option, what the command does read and what it takes besides, nothing written. `init --strict` would otherwise say the briefs had been set up strictly, and `init --config team.json` that the configuration had been written there.
+
+| Command | Refuses | Because it would say |
+| --- | --- | --- |
+| `init` | `--config`, `--strict`, `--color` | That the configuration was written to the file named, where `.spec-brief.json` is; that something was strict, where `init` has no warning to fail on; that colour was printed, where it prints none. |
+| `new` | `--strict`, `--color` | That a warning would have failed it, where it has none; that colour was printed, where it prints none. |
+| `list` | `--strict` | That a warning would have failed it, where it reports no finding. |
+
+```text
+spec-brief: init does not read --strict; it reads --root, --format, --briefs and --archive, and takes --no-config, --no-git and --no-color
+```
+
+- **Two options of which one would go unread** are refused together, for the same reason: `--config <file>` beside `--no-config` says the file was read, where the defaults ran and it was never opened, and `--color` beside `--no-color` that colour was forced on, where it was off. Give one of the two.
+- **An option that asks a command to leave out what it never does is taken**, since it asks for what is already so: `--no-color` by `init` and `new`, which print no colour, `--no-git` by `init`, which asks git nothing, and `--no-config` by `init`, which opens no configuration file. A script that runs every command in a tree without git, or into a log, passes such an option to each of them. `init --no-config` still writes over no configuration: where one is there, it stops as `init` does.
+- **An option a format has nothing to read for is taken**: `--no-color` or `--color` beside `--format json` changes nothing, and a caller that asks for JSON passes `--no-color` beside it.
+- **`--help` and `--version` answer first**: `init --strict --help` prints the help.
+
+### Today's date
+
+`new` writes a date into the front matter and `archive` one into the banner: the one `--date` gives, or today's. Today is the clock's date in UTC, unless `SOURCE_DATE_EPOCH` is set, the variable a pipeline sets to have every run write the same bytes ([its specification](https://reproducible-builds.org/specs/source-date-epoch/)): then it is the date of that time, in UTC.
+
+- **What it holds**: whole seconds since 1970-01-01 in digits alone, as `date +%s` prints them, from `0` to `253402300799`, the last second of 9999-12-31 and of the dates written `YYYY-MM-DD`.
+- **Anything else is refused**, never read as unset: a word, `1.5`, `-1`, a space or a newline beside the digits, a later time, or nothing at all, which is what `SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)` leaves where git failed. `new` and `archive` then write nothing and exit 2 with a line that names the variable and shows what it holds. The clock's date, written where a pipeline asked for its own, would look like any other.
+- **Only a run that would use it reads it**: `--date` gives the date instead, and `init`, `lint`, `list`, `matrix`, `schedule`, `unarchive`, `--version` and `--help` write none, so each runs whatever the variable holds.
+
 ## Configuration
 
 `.spec-brief.json` (or `spec-brief.json`) at the root; the nearest one above the working directory is used, and its directory is the root. It is JSON, validated against [`schema.json`](schema.json): an unknown key, a misspelt rule or a value of the wrong type stops the run with exit 2 rather than falling back to defaults and reporting on the wrong rules.

package/dist/cli.js

@@ -6,7 +6,7 @@
  * that does not load, a brief that does not exist. A run that checked nothing
  * must never exit as though it found nothing.
  */
-import { readFile } from 'node:fs/promises';
+import { readFile, stat } from 'node:fs/promises';
 import { parseArgs } from 'node:util';
 import { TransactionError, ConflictError } from './apply.js';
 import { reported } from './collisions.js';
@@ -39,7 +39,11 @@ const GLOBAL = {
     version: { type: 'boolean', short: 'v' },
 };
 const TABLE = {
-    init: { options: { briefs: { type: 'string' }, archive: { type: 'string' } }, formats: ['pretty', 'json'] },
+    init: {
+        options: { briefs: { type: 'string' }, archive: { type: 'string' } },
+        formats: ['pretty', 'json'],
+        noArgument: '; --root <dir> names the directory it sets up, and --briefs <dir> the one for the briefs',
+    },
     new: {
         options: {
             id: { type: 'string' },
@@ -51,9 +55,9 @@ const TABLE = {
         formats: ['pretty', 'json'],
     },
     lint: { options: {}, formats: FORMATS },
-    list: { options: { ready: { type: 'boolean' }, archived: { type: 'boolean' } }, formats: ['pretty', 'json'] },
-    matrix: { options: { 'all-waves': { type: 'boolean' } }, formats: FORMATS },
-    schedule: { options: { write: { type: 'boolean' } }, formats: FORMATS },
+    list: { options: { ready: { type: 'boolean' }, archived: { type: 'boolean' } }, formats: ['pretty', 'json'], noArgument: '' },
+    matrix: { options: { 'all-waves': { type: 'boolean' } }, formats: FORMATS, noArgument: '' },
+    schedule: { options: { write: { type: 'boolean' } }, formats: FORMATS, noArgument: '' },
     archive: {
         options: {
             pr: { type: 'string' },
@@ -68,6 +72,87 @@ const TABLE = {
     },
     unarchive: { options: { 'dry-run': { type: 'boolean' } }, formats: ['pretty', 'json'] },
 };
+/**
+ * Whether taking the option would tell someone what is not so. `init
+ * --strict` says the briefs were set up strictly, where nothing was strict;
+ * `init --config team.json` that the configuration was written there, where
+ * `.spec-brief.json` was; `init --color` and `new --color` that colour was
+ * printed, where neither prints any; `new --strict` and `list --strict` that
+ * a warning would have failed the run, where neither has one. Each ran as
+ * the line without the option does, exit 0.
+ *
+ * A function, not a table beside the commands': a table built when the
+ * module loads is static to Stryker, and each of its mutants then runs the
+ * whole suite (ADR-0009).
+ */
+function untrue(command, option) {
+    switch (option) {
+        case 'config':
+            return command === 'init';
+        case 'strict':
+            return command === 'init' || command === 'new' || command === 'list';
+        case 'color':
+            return command === 'init' || command === 'new';
+        // Each caller asks only whether the answer is true, so the mutant that
+        // leaves this case out, and answers nothing, is equivalent.
+        default:
+            return false;
+    }
+}
+/**
+ * Whether the option asks the command to leave out what it never does, and
+ * so asks for what is already so: `init` opens no configuration file and
+ * asks git nothing, and neither it nor `new` prints colour. Such an option
+ * is taken. A script that runs every command in a tree without git, or into
+ * a log, passes it to each of them, as spec-harness passes `--no-color`.
+ * The command reads nothing of it, so a refusal's line lists it apart from
+ * what the command reads, as taken.
+ */
+function alreadySo(command, option) {
+    switch (option) {
+        case 'no-config':
+        case 'no-git':
+            return command === 'init';
+        case 'no-color':
+            return command === 'init' || command === 'new';
+        // Each caller asks only whether the answer is true, so the mutant that
+        // leaves this case out, and answers nothing, is equivalent.
+        default:
+            return false;
+    }
+}
+/** Options by their names on the command line, as a sentence lists them. */
+function listed(names) {
+    const options = names.map((name) => `--${name}`);
+    return options.length === 1 ? options[0] : `${options.slice(0, -1).join(', ')} and ${options.at(-1)}`;
+}
+/**
+ * Why a command line that parsed is still not one to run.
+ *
+ * An option is refused where taking it would tell someone what is not so,
+ * and so are two options of which one would go unread: `--config team.json
+ * --no-config` says the file was read, where the defaults ran, and `--color
+ * --no-color` that colour was forced on, where it was off. An option that
+ * asks a command to leave out what it never does asks for what is already
+ * so, and is taken.
+ */
+function unread(command, spec, values) {
+    // The first such option as the line was typed, which is the order the
+    // parser keeps.
+    const stray = Object.keys(values).find((option) => untrue(command, option));
+    if (stray !== undefined) {
+        const shared = Object.keys(GLOBAL).filter((option) => option !== 'help' && option !== 'version' && !untrue(command, option));
+        const reads = [...shared.filter((option) => !alreadySo(command, option)), ...Object.keys(spec.options)];
+        const takes = shared.filter((option) => alreadySo(command, option));
+        return `${command} does not read --${stray}; it reads ${listed(reads)}${takes.length > 0 ? `, and takes ${listed(takes)}` : ''}`;
+    }
+    if (text(values, 'config') !== undefined && flag(values, 'no-config')) {
+        return '--config is given beside --no-config, which has the run read no configuration file; give one of the two';
+    }
+    if (flag(values, 'color') && flag(values, 'no-color'))
+        return '--color is given beside --no-color, which turns colour off; give one of the two';
+    return null;
+}
 /**
  * The commands by name, and nothing for a command line that names none. A map,
  * because an object answers to more names than it was given: `constructor` and
@@ -104,14 +189,14 @@ Commands:
   archive <brief>       close a round: check it, stamp it, freeze it, move it
   unarchive <brief>     reopen an archived brief
 
-Options for every command:
-  --root <dir>          run from this directory instead of the current one
-  --config <file>       use this configuration file
+Options for every command, except where a line says otherwise:
+  --root <dir>          run from this directory instead of the current one; it must exist, unless init makes it
+  --config <file>       use this configuration file; not for init, which writes .spec-brief.json
   --no-config           use the defaults, ignoring any configuration file
   --format <format>     the output format, pretty by default; each command's are below
-  --strict              treat warnings as errors
+  --strict              treat warnings as errors; not for init, new or list, which have none
   --no-git              leave git out; read the files on disk instead
-  --color, --no-color   force colour on or off
+  --color, --no-color   force colour on or off; --color not for init or new, which print none
   -h, --help            show this help
   -v, --version         show the version
 
@@ -127,7 +212,7 @@ new:
   --type <type>         a brief type from the configuration
   --wave <n>            the wave it runs in
   --depends-on <ids>    comma-separated ids it runs after
-  --date <YYYY-MM-DD>   the date in its front matter; default today
+  --date <YYYY-MM-DD>   the date in its front matter; default SOURCE_DATE_EPOCH's, or today's in UTC
 
 list:
   --ready               only briefs that can run now: dependencies archived, not drafts or deferred
@@ -144,13 +229,20 @@ archive:
   --commit <rev>        the commit the round landed as
   --base <rev>          the branch it started from; the diff runs from the merge base
   --summary <text>      what the round did, for the banner
-  --date <YYYY-MM-DD>   the archival date; default today
+  --date <YYYY-MM-DD>   the archival date; default SOURCE_DATE_EPOCH's, or today's in UTC
   --allow-dirty         archive although the tree has uncommitted work
   --dry-run             print the plan and change nothing
 
 unarchive:
   --dry-run             print the plan and change nothing
 
+An option given an empty value, a list that names nothing and an argument a
+command does not take are refused, not read as if they were not there. So is
+an option where taking it would say what is not so, as init --strict, and so
+are --config beside --no-config and --color beside --no-color, of which one
+would go unread. An option that asks a command to leave out what it never
+does is taken, as init --no-git: it asks for what is already so.
+
 Exit codes: 0 clean, 1 findings or refused, 2 the run could not be trusted.
 `;
 /** Global options that take a value, so the value is not mistaken for the command. */
@@ -175,18 +267,34 @@ export function parse(argv) {
     if (command !== undefined && spec === undefined) {
         throw new UsageError(`"${command}" is not a command; run spec-brief --help`);
     }
+    let parsed;
     try {
-        const { values, positionals } = parseArgs({
+        parsed = parseArgs({
             args: [...argv],
             options: { ...GLOBAL, ...(spec?.options ?? {}) },
             allowPositionals: true,
             strict: true,
         });
-        return { command, values: values, positionals: positionals.slice(1) };
     }
     catch (error) {
         throw new UsageError(error.message);
     }
+    const positionals = parsed.positionals.slice(1);
+    // What the parser takes is not yet what names something. An option whose
+    // value is empty, as `--root "$DIR"` is where the variable is not set, was
+    // read as the option left out, and an argument no command asked for was
+    // dropped: either way the run answered a question nobody had put, exit 0.
+    for (const [name, value] of Object.entries(parsed.values)) {
+        if (typeof value === 'string' && value.trim() === '') {
+            // Shown as JSON, where a tab or a line break in it can be seen.
+            throw new UsageError(`--${name} is ${JSON.stringify(value)}, which is no value; give it one, or leave the option out`);
+        }
+    }
+    if (spec?.noArgument !== undefined && positionals.length > 0) {
+        const extra = positionals.map((argument) => `"${argument}"`).join(', ');
+        throw new UsageError(`${command} takes no argument, not ${extra}: spec-brief ${command}${spec.noArgument}`);
+    }
+    return { command, values: parsed.values, positionals };
 }
 /** The value of an option declared a string, which is all `parseArgs` gives one. */
 function text(values, key) {
@@ -215,9 +323,17 @@ function useColor(values, io) {
     const env = io.env ?? process.env;
     if ((env['NO_COLOR'] ?? '') !== '')
         return false;
+    // Off for exactly "0" and exactly "false": Node itself and supports-color
+    // read "false" as off, and here it forced colour on. Any other value that
+    // is not empty is on, "FALSE" too, which is the one reading the family's
+    // tools share (spec-core ADR-0005).
     const force = env['FORCE_COLOR'];
     if (force !== undefined && force !== '')
-        return force !== '0';
+        return force !== '0' && force !== 'false';
+    // A terminal that says it is dumb has asked for no escape sequence, and
+    // Node itself counts one colour for it: the family's tools read it alike.
+    if (env['TERM'] === 'dumb')
+        return false;
     return (io.stdout ?? process.stdout).isTTY === true;
 }
 async function openEngine(run) {
@@ -292,18 +408,26 @@ async function runNew(run) {
     const title = run.positionals.join(' ').trim();
     if (title === '')
         throw new UsageError('new needs a title: spec-brief new "<title>"');
+    const listed = text(run.values, 'depends-on');
+    const dependsOn = listed?.split(',').map((d) => d.trim());
+    // A list that names no brief is not a brief that depends on none: written
+    // as given, "," scaffolded a brief with no dependency and said nothing.
+    if (dependsOn?.every((d) => d === '')) {
+        throw new UsageError(`--depends-on is ${JSON.stringify(listed)}, which names no brief; give it ids with commas between them, as in 7,8, or leave the option out`);
+    }
+    // And a place in it that names none is a brief left out: "$A,$B" with one
+    // of the two unset scaffolded a brief that depends on the other alone.
+    if (dependsOn?.includes('')) {
+        throw new UsageError(`--depends-on is ${JSON.stringify(listed)}, which names no brief in one of its places; give it ids with one comma between each two, as in 7,8, and none before or after`);
+    }
     const engine = await openEngine(run);
-    const dependsOn = text(run.values, 'depends-on')
-        ?.split(',')
-        .map((d) => d.trim())
-        .filter((d) => d !== '');
     const created = await engine.create({
         title,
         id: text(run.values, 'id'),
         type: text(run.values, 'type'),
         wave: integer(run.values, 'wave', 0),
         dependsOn,
-        date: text(run.values, 'date') ?? run.today,
+        date: text(run.values, 'date') ?? run.today(),
     });
     if (run.format === 'json')
         run.out(jsonDocument('new', run.version, { ok: true, file: created.file }));
@@ -389,7 +513,7 @@ async function runTransition(run, action) {
             commit: text(run.values, 'commit'),
             base: text(run.values, 'base'),
             summary: text(run.values, 'summary'),
-            date: text(run.values, 'date') ?? run.today,
+            date: text(run.values, 'date') ?? run.today(),
             allowDirty: flag(run.values, 'allow-dirty'),
             strict: run.strict,
             noGit: flag(run.values, 'no-git'),
@@ -420,7 +544,7 @@ export async function main(argv = process.argv.slice(2), io = {}) {
     }
     const { command, values, positionals } = parsed;
     // From here on, so that what comes before a command is covered as the
-    // command is: --version and --help, the package's own manifest, the date.
+    // command is: --version and --help, the package's own manifest, the colour.
     // An error there left main as a rejection, which the launcher ended as
     // Node's uncaught error with exit 1, "findings" to a script.
     try {
@@ -434,13 +558,28 @@ export async function main(argv = process.argv.slice(2), io = {}) {
             return flag(values, 'help') ? EXIT_OK : EXIT_ERROR;
         }
         const spec = COMMANDS.get(command);
+        const refusal = unread(command, spec, values);
+        if (refusal !== null)
+            throw new UsageError(refusal);
         const format = (text(values, 'format') ?? 'pretty');
         if (!spec.formats.includes(format)) {
             err(`--format for ${command} is one of ${spec.formats.join(', ')}, not "${format}"`);
             return EXIT_ERROR;
         }
+        // A file, or a name with nothing behind it, had the search for a
+        // configuration go on from its parent: the run reported on a tree nobody
+        // had named, and `new` wrote into it. A path that cannot be reached is
+        // not there to the run either. `init` alone is given a directory that
+        // does not exist yet, which it makes.
+        const root = text(values, 'root');
+        if (root !== undefined) {
+            const found = await stat(root).catch(() => null);
+            if (found === null ? command !== 'init' : !found.isDirectory()) {
+                throw new UsageError(`--root is "${root}", which is no directory; give it one, or leave the option out`);
+            }
+        }
         const run = {
-            today: today(io.env ?? process.env),
+            today: () => today(io.env ?? process.env),
             out: (t) => {
                 stdout.write(t);
             },

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAwB,MAAM,WAAW,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EACL,SAAS,EACT,WAAW,EACX,OAAO,EAEP,cAAc,EACd,iBAAiB,EACjB,YAAY,EAEZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,UAAU,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,KAAK,EACL,YAAY,EACZ,YAAY,EAEZ,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAE5B,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAWD,MAAM,MAAM,GAA4C;IACtD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAChC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1B,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACrC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;CACzC,CAAC;AAOF,MAAM,KAAK,GAA0C;IACnD,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;IAC3G,GAAG,EAAE;QACH,OAAO,EAAE;YACP,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACzB;QACD,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC5B;IACD,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;IACvC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;IAC7G,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;IAC3E,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;IACvE,OAAO,EAAE;QACP,OAAO,EAAE;YACP,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC/B;QACD,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC5B;IACD,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;CACxF,CAAC;AAEF;;;;GAIG;AACH,MAAM,QAAQ,GAAiD,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAE9F;;;;GAIG;AACH,SAAS,WAAW;IAClB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAU,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BlB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCd,CAAC;AAQF,sFAAsF;AACtF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAE3D,SAAS,SAAS,CAAC,IAAuB;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAW,CAAC;QAC9B,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IACvC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAuB;IAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,OAAO,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAAC,IAAI,OAAO,2CAA2C,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;YACxC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE;YAChD,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAgB,EAAE,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,SAAS,IAAI,CAAC,MAAc,EAAE,GAAW;IACvC,OAAO,MAAM,CAAC,GAAG,CAAuB,CAAC;AAC3C,CAAC;AAED,SAAS,IAAI,CAAC,MAAc,EAAE,GAAW;IACvC,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAC9B,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,GAAW,EAAE,OAAe;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO;QAAE,MAAM,IAAI,UAAU,CAAC,KAAK,GAAG,uCAAuC,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC;IAC9I,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,OAAO;IACpB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAwB,CAAC;IACnH,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAgBD,SAAS,QAAQ,CAAC,MAAc,EAAE,EAAS;IACzC,IAAI,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,KAAK,GAAG,CAAC;IAC9D,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,GAAQ;IAChC,OAAO,WAAW,CAAC,IAAI,CAAC;QACtB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG;QACxC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;QAClC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;KACxC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,GAAQ,EAAE,OAAe,EAAE,QAA4B,EAAE,OAAe,EAAE,KAAK,GAA4B,EAAE;IACjI,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;YACnJ,MAAM;QACR,KAAK,OAAO;YACV,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACtC,MAAM;QACR,KAAK,QAAQ;YACX,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;YAClC,MAAM;QACR,KAAK,QAAQ;YACX,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;YACrC,MAAM;QACR,KAAK,QAAQ;YACX,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/E,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,gCAAgC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,OAAO,WAAW,IAAI,CAAC,CAAC;YACvI,MAAM;IACV,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAAQ;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC;IACjD,MAAM,EAAE,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC;IAClG,CAAC;IACD,yEAAyE;IACzE,8DAA8D;IAC9D,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,KAAa,EAAU,EAAE;QACvD,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,UAAU,CAAC,KAAK,MAAM,oDAAoD,KAAK,GAAG,CAAC,CAAC;QAChG,CAAC;IACH,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,GAAG,MAAM,UAAU,CAAC,CAAC;IACtF,IAAI,MAAM,KAAK,EAAE,IAAI,OAAO,KAAK,EAAE,IAAI,MAAM,KAAK,OAAO;QAAE,MAAM,IAAI,UAAU,CAAC,gDAAgD,CAAC,CAAC;IAClI,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAC9E,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;QAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;;QACxF,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACjG,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,GAAQ;IAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,KAAK,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,6CAA6C,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;QAC9C,EAAE,KAAK,CAAC,GAAG,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;QAClC,KAAK;QACL,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;QAC1B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACpC,SAAS;QACT,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK;KAC5C,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;QAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;;QAClG,GAAG,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAAQ;IAC7B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,CAAC,aAAa,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC;IACpG,OAAO,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACjG,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAAQ;IAC7B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,CAAC,aAAa,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IACxF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAc,MAAM;SAC3B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SACxF,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1B,GAAG,CAAC,GAAG,CACL,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE;YAChC,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YACvF,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC;SACtC,CAAC,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAQ;IAC/B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,CAAC,aAAa,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IAC7F,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC5B,oFAAoF;QACpF,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzE,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,CAAC;IACD,OAAO,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,WAAW,CAAC,GAAQ;IACjC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,CAAC,aAAa,EAAE,CAAC;IACvB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACjE,IAAI,OAAO,GAAoB,IAAI,CAAC;IACpC,IAAI,QAAQ,GAAc,QAAQ,CAAC;IACnC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACzB,iFAAiF;QACjF,QAAQ,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1H,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC5B,GAAG,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;QAC/F,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,KAAK,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvE,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,CAAC;IACD,OAAO,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAClH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAQ,EAAE,MAA+B;IACpE,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,MAAM,gCAAgC,MAAM,UAAU,CAAC,CAAC;IAC3I,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,MAAM,IAAI,GACR,MAAM,KAAK,SAAS;QAClB,CAAC,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE;YAClC,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;YAC9B,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;YACpC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK;YAC3C,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;YAC3C,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC;QACJ,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;QAAE,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;QAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;;QACjH,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAsB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAU,EAAE;IACxF,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC3C,MAAM,GAAG,GAAG,CAAC,OAAe,EAAQ,EAAE;QACpC,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC;IACF,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAChD,sEAAsE;IACtE,0EAA0E;IAC1E,uEAAuE;IACvE,6DAA6D;IAC7D,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,OAAO,EAAE,IAAI,CAAC,CAAC;YACrC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnB,4FAA4F;YAC5F,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QACrD,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAgB,CAAC;QAClD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAW,CAAC;QAC9D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,gBAAgB,OAAO,cAAc,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,GAAG,CAAC,CAAC;YACrF,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,MAAM,GAAG,GAAQ;YACf,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;YACnC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;gBACT,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,GAAG;YACH,sEAAsE;YACtE,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;YACtC,MAAM;YACN,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;YAC9B,OAAO,EAAE,MAAM,OAAO,EAAE;YACxB,MAAM;YACN,WAAW;YACX,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;SAC7B,CAAC;QACF,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM;gBACT,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,KAAK,KAAK;gBACR,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,KAAK,MAAM;gBACT,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,KAAK,MAAM;gBACT,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,KAAK,QAAQ;gBACX,OAAO,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;YAC9B,KAAK,UAAU;gBACb,OAAO,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;YAChC,KAAK,SAAS;gBACZ,OAAO,MAAM,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC7C;gBACE,OAAO,MAAM,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uEAAuE;QACvE,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QACnG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,YAAY,IAAI,CAAC,EAAE,CAAC;YACnD,GAAG,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,sEAAsE;QACtE,0EAA0E;QAC1E,sEAAsE;QACtE,sEAAsE;QACtE,2EAA2E;QAC3E,mCAAmC;QACnC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;YAAE,GAAG,CAAC,qBAAqB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;aACpE,IAAK,KAA+B,CAAC,IAAI,KAAK,OAAO;YAAE,GAAG,CAAC,wDAAwD,CAAC,CAAC;;YACrH,GAAG,CAAC,qBAAqB,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC","sourcesContent":["/**\n * The command line: argument parsing, dispatch, output and exit codes.\n *\n * Exit 0: done, nothing found. Exit 1: findings, collisions, or an action\n * refused. Exit 2: the run could not be trusted - a bad flag, a configuration\n * that does not load, a brief that does not exist. A run that checked nothing\n * must never exit as though it found nothing.\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { parseArgs, type ParseArgsConfig } from 'node:util';\n\nimport { TransactionError, ConflictError } from './apply.js';\nimport type { Plan } from './archive.js';\nimport { reported } from './collisions.js';\nimport { CONFIG_FILES, ConfigError, initialConfig } from './config.js';\nimport { BriefEngine, EngineError, today } from './engine.js';\nimport { NodeFileSystem } from './fs.js';\nimport { GitError } from './git.js';\nimport { failing, sortFindings, summarise } from './lint.js';\nimport { normalisePath } from './links.js';\nimport {\n  briefJson,\n  findingJson,\n  FORMATS,\n  type Format,\n  githubCommands,\n  gitlabCodeQuality,\n  jsonDocument,\n  type ListRow,\n  matrixJson,\n  planJson,\n  prettyFindings,\n  prettyList,\n  prettyMatrix,\n  prettyPlan,\n  prettySchedule,\n  sarif,\n  scheduleJson,\n  sectionsJson,\n  type Style,\n  summaryLine,\n} from './report.js';\nimport type { Finding } from './types.js';\n\nexport const EXIT_OK = 0;\nexport const EXIT_FAILED = 1;\nexport const EXIT_ERROR = 2;\n\nexport class UsageError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'UsageError';\n  }\n}\n\nexport interface CliIO {\n  readonly stdout?: { write(text: string): unknown; readonly isTTY?: boolean };\n  readonly stderr?: { write(text: string): unknown };\n  readonly cwd?: string;\n  readonly env?: Readonly<Record<string, string | undefined>>;\n}\n\ntype Values = Record<string, string | boolean | undefined>;\n\nconst GLOBAL: NonNullable<ParseArgsConfig['options']> = {\n  root: { type: 'string' },\n  config: { type: 'string' },\n  'no-config': { type: 'boolean' },\n  format: { type: 'string' },\n  strict: { type: 'boolean' },\n  'no-git': { type: 'boolean' },\n  color: { type: 'boolean' },\n  'no-color': { type: 'boolean' },\n  help: { type: 'boolean', short: 'h' },\n  version: { type: 'boolean', short: 'v' },\n};\n\ninterface CommandSpec {\n  readonly options: NonNullable<ParseArgsConfig['options']>;\n  readonly formats: readonly Format[];\n}\n\nconst TABLE: Readonly<Record<string, CommandSpec>> = {\n  init: { options: { briefs: { type: 'string' }, archive: { type: 'string' } }, formats: ['pretty', 'json'] },\n  new: {\n    options: {\n      id: { type: 'string' },\n      type: { type: 'string' },\n      wave: { type: 'string' },\n      'depends-on': { type: 'string' },\n      date: { type: 'string' },\n    },\n    formats: ['pretty', 'json'],\n  },\n  lint: { options: {}, formats: FORMATS },\n  list: { options: { ready: { type: 'boolean' }, archived: { type: 'boolean' } }, formats: ['pretty', 'json'] },\n  matrix: { options: { 'all-waves': { type: 'boolean' } }, formats: FORMATS },\n  schedule: { options: { write: { type: 'boolean' } }, formats: FORMATS },\n  archive: {\n    options: {\n      pr: { type: 'string' },\n      commit: { type: 'string' },\n      base: { type: 'string' },\n      summary: { type: 'string' },\n      date: { type: 'string' },\n      'allow-dirty': { type: 'boolean' },\n      'dry-run': { type: 'boolean' },\n    },\n    formats: ['pretty', 'json'],\n  },\n  unarchive: { options: { 'dry-run': { type: 'boolean' } }, formats: ['pretty', 'json'] },\n};\n\n/**\n * The commands by name, and nothing for a command line that names none. A map,\n * because an object answers to more names than it was given: `constructor` and\n * `toString` are no commands.\n */\nconst COMMANDS: ReadonlyMap<string | undefined, CommandSpec> = new Map(Object.entries(TABLE));\n\n/**\n * The formats each command writes, read from the table `main` checks a\n * `--format` against, so the help names no format a command refuses: the\n * finding formats are `lint`'s, `matrix`'s and `schedule`'s alone.\n */\nfunction formatsHelp(): string {\n  const groups = new Map<string, string[]>();\n  for (const [command, spec] of Object.entries(TABLE)) {\n    const formats = spec.formats.join(', ');\n    groups.set(formats, [...(groups.get(formats) ?? []), command]);\n  }\n  const rows = [...groups].map(([formats, commands]) => [commands.join(', '), formats] as const);\n  const width = Math.max(...rows.map(([commands]) => commands.length));\n  return rows.map(([commands, formats]) => `  ${commands.padEnd(width)}  ${formats}`).join('\\n');\n}\n\nexport const HELP = `spec-brief - lint, schedule and archive task briefs\n\nUsage:\n  spec-brief <command> [options]\n\nCommands:\n  init                  write .spec-brief.json and the brief directories\n  new <title>           scaffold a brief with the next free id\n  lint [brief...]       check briefs against the configuration\n  list                  briefs with their status, wave and readiness\n  matrix                scope collisions between briefs in the same wave\n  schedule              the waves the live briefs can run in, computed\n  archive <brief>       close a round: check it, stamp it, freeze it, move it\n  unarchive <brief>     reopen an archived brief\n\nOptions for every command:\n  --root <dir>          run from this directory instead of the current one\n  --config <file>       use this configuration file\n  --no-config           use the defaults, ignoring any configuration file\n  --format <format>     the output format, pretty by default; each command's are below\n  --strict              treat warnings as errors\n  --no-git              leave git out; read the files on disk instead\n  --color, --no-color   force colour on or off\n  -h, --help            show this help\n  -v, --version         show the version\n\nFormats:\n${formatsHelp()}\n\ninit:\n  --briefs <dir>        the directory of live briefs; default briefs\n  --archive <dir>       the directory of archived briefs; default <briefs>/archive\n\nnew:\n  --id <id>             use this id instead of the next free one\n  --type <type>         a brief type from the configuration\n  --wave <n>            the wave it runs in\n  --depends-on <ids>    comma-separated ids it runs after\n  --date <YYYY-MM-DD>   the date in its front matter; default today\n\nlist:\n  --ready               only briefs that can run now: dependencies archived, not drafts or deferred\n  --archived            include archived briefs\n\nmatrix:\n  --all-waves           compare every live brief, whatever its wave\n\nschedule:\n  --write               write each proposed wave into its brief's front matter\n\narchive:\n  --pr <number>         the pull request the round merged in\n  --commit <rev>        the commit the round landed as\n  --base <rev>          the branch it started from; the diff runs from the merge base\n  --summary <text>      what the round did, for the banner\n  --date <YYYY-MM-DD>   the archival date; default today\n  --allow-dirty         archive although the tree has uncommitted work\n  --dry-run             print the plan and change nothing\n\nunarchive:\n  --dry-run             print the plan and change nothing\n\nExit codes: 0 clean, 1 findings or refused, 2 the run could not be trusted.\n`;\n\ninterface Parsed {\n  readonly command: string | undefined;\n  readonly values: Values;\n  readonly positionals: readonly string[];\n}\n\n/** Global options that take a value, so the value is not mistaken for the command. */\nconst VALUED = new Set(['--root', '--config', '--format']);\n\nfunction commandOf(argv: readonly string[]): string | undefined {\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i] as string;\n    if (arg === '--') return argv[i + 1];\n    if (VALUED.has(arg)) {\n      i += 1;\n      continue;\n    }\n    if (!arg.startsWith('-')) return arg;\n  }\n  return undefined;\n}\n\nexport function parse(argv: readonly string[]): Parsed {\n  const command = commandOf(argv);\n  const spec = COMMANDS.get(command);\n  if (command !== undefined && spec === undefined) {\n    throw new UsageError(`\"${command}\" is not a command; run spec-brief --help`);\n  }\n  try {\n    const { values, positionals } = parseArgs({\n      args: [...argv],\n      options: { ...GLOBAL, ...(spec?.options ?? {}) },\n      allowPositionals: true,\n      strict: true,\n    });\n    return { command, values: values as Values, positionals: positionals.slice(1) };\n  } catch (error) {\n    throw new UsageError((error as Error).message);\n  }\n}\n\n/** The value of an option declared a string, which is all `parseArgs` gives one. */\nfunction text(values: Values, key: string): string | undefined {\n  return values[key] as string | undefined;\n}\n\nfunction flag(values: Values, key: string): boolean {\n  return values[key] === true;\n}\n\nfunction integer(values: Values, key: string, minimum: number): number | undefined {\n  const raw = text(values, key);\n  if (raw === undefined) return undefined;\n  if (!/^\\d+$/.test(raw) || Number(raw) < minimum) throw new UsageError(`--${key} must be a whole number of at least ${minimum}, not \"${raw}\"`);\n  return Number(raw);\n}\n\nasync function version(): Promise<string> {\n  const pkg = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8')) as { version: string };\n  return pkg.version;\n}\n\ninterface Run {\n  /** Today, as the environment the run was given says. */\n  readonly today: string;\n  readonly out: (text: string) => void;\n  readonly err: (text: string) => void;\n  readonly style: Style;\n  readonly format: Format;\n  readonly strict: boolean;\n  readonly version: string;\n  readonly values: Values;\n  readonly positionals: readonly string[];\n  readonly cwd: string;\n}\n\nfunction useColor(values: Values, io: CliIO): boolean {\n  if (flag(values, 'no-color')) return false;\n  if (flag(values, 'color')) return true;\n  const env = io.env ?? process.env;\n  if ((env['NO_COLOR'] ?? '') !== '') return false;\n  const force = env['FORCE_COLOR'];\n  if (force !== undefined && force !== '') return force !== '0';\n  return (io.stdout ?? process.stdout).isTTY === true;\n}\n\nasync function openEngine(run: Run): Promise<BriefEngine> {\n  return BriefEngine.open({\n    cwd: text(run.values, 'root') ?? run.cwd,\n    config: text(run.values, 'config'),\n    ...(flag(run.values, 'no-git') ? { git: null } : {}),\n    noConfig: flag(run.values, 'no-config'),\n  });\n}\n\nfunction emitFindings(run: Run, command: string, findings: readonly Finding[], checked: number, extra: Record<string, unknown> = {}): number {\n  const failed = failing(findings, run.strict);\n  switch (run.format) {\n    case 'json':\n      run.out(jsonDocument(command, run.version, { ok: !failed, checked, summary: summarise(findings), findings: findings.map(findingJson), ...extra }));\n      break;\n    case 'sarif':\n      run.out(sarif(findings, run.version));\n      break;\n    case 'github':\n      run.out(githubCommands(findings));\n      break;\n    case 'gitlab':\n      run.out(gitlabCodeQuality(findings));\n      break;\n    case 'pretty':\n      if (findings.length > 0) run.out(`${prettyFindings(findings, run.style)}\\n\\n`);\n      run.out(`${findings.length === 0 ? `${checked} brief(s) checked, no findings` : `${summaryLine(findings)} in ${checked} brief(s)`}\\n`);\n      break;\n  }\n  return failed ? EXIT_FAILED : EXIT_OK;\n}\n\nasync function runInit(run: Run): Promise<number> {\n  const root = text(run.values, 'root') ?? run.cwd;\n  const fs = new NodeFileSystem(root);\n  for (const name of CONFIG_FILES) {\n    if (await fs.exists(name)) throw new UsageError(`${name} already exists here; edit it instead`);\n  }\n  // A directory above the root is refused as the configuration refuses one\n  // (config.ts), in the same words, before anything is written.\n  const inside = (option: string, given: string): string => {\n    try {\n      return normalisePath(given);\n    } catch {\n      throw new UsageError(`--${option} must be a directory inside the repository, not \"${given}\"`);\n    }\n  };\n  const briefs = inside('briefs', text(run.values, 'briefs') ?? 'briefs');\n  const archive = inside('archive', text(run.values, 'archive') ?? `${briefs}/archive`);\n  if (briefs === '' || archive === '' || briefs === archive) throw new UsageError('--briefs and --archive must be two directories');\n  const config = `${JSON.stringify(initialConfig(briefs, archive), null, 2)}\\n`;\n  await fs.write('.spec-brief.json', config);\n  const written = ['.spec-brief.json'];\n  for (const dir of [briefs, archive]) {\n    const keep = `${dir}/.gitkeep`;\n    if ((await fs.list(dir)) === null) {\n      await fs.write(keep, '');\n      written.push(keep);\n    }\n  }\n  if (run.format === 'json') run.out(jsonDocument('init', run.version, { ok: true, written }));\n  else run.out(`${written.map((w) => `wrote ${w}`).join('\\n')}\\nnext: spec-brief new \"<title>\"\\n`);\n  return EXIT_OK;\n}\n\nasync function runNew(run: Run): Promise<number> {\n  const title = run.positionals.join(' ').trim();\n  if (title === '') throw new UsageError('new needs a title: spec-brief new \"<title>\"');\n  const engine = await openEngine(run);\n  const dependsOn = text(run.values, 'depends-on')\n    ?.split(',')\n    .map((d) => d.trim())\n    .filter((d) => d !== '');\n  const created = await engine.create({\n    title,\n    id: text(run.values, 'id'),\n    type: text(run.values, 'type'),\n    wave: integer(run.values, 'wave', 0),\n    dependsOn,\n    date: text(run.values, 'date') ?? run.today,\n  });\n  if (run.format === 'json') run.out(jsonDocument('new', run.version, { ok: true, file: created.file }));\n  else run.out(`wrote ${created.file}\\n`);\n  return EXIT_OK;\n}\n\nasync function runLint(run: Run): Promise<number> {\n  const engine = await openEngine(run);\n  engine.requireBriefs();\n  const findings = await engine.lint(run.positionals);\n  const checked = run.positionals.length === 0 ? engine.corpus.briefs.length : run.positionals.length;\n  return emitFindings(run, 'lint', findings, checked, { sections: sectionsJson(engine.config) });\n}\n\nasync function runList(run: Run): Promise<number> {\n  const engine = await openEngine(run);\n  engine.requireBriefs();\n  const briefs = flag(run.values, 'archived') ? engine.corpus.briefs : engine.corpus.live;\n  const ready = new Set(engine.ready());\n  const rows: ListRow[] = briefs\n    .map((brief) => ({ brief, ready: ready.has(brief), waitingOn: engine.waitingOn(brief) }))\n    .filter((row) => !flag(run.values, 'ready') || row.ready);\n  if (run.format === 'json') {\n    run.out(\n      jsonDocument('list', run.version, {\n        ok: true,\n        briefs: rows.map((r) => briefJson(r.brief, { ready: r.ready, waitingOn: r.waitingOn })),\n        sections: sectionsJson(engine.config),\n      }),\n    );\n  } else {\n    run.out(`${prettyList(rows, run.style)}\\n`);\n  }\n  return EXIT_OK;\n}\n\nasync function runMatrix(run: Run): Promise<number> {\n  const engine = await openEngine(run);\n  engine.requireBriefs();\n  const { report, findings } = await engine.collisions({ all: flag(run.values, 'all-waves') });\n  const sorted = sortFindings(findings);\n  if (run.format === 'pretty') {\n    // Drawn from what the run reports, so a rule that is off marks nothing in the grid.\n    run.out(`${prettyMatrix(reported(engine.corpus, report), run.style)}\\n`);\n    return failing(sorted, run.strict) ? EXIT_FAILED : EXIT_OK;\n  }\n  return emitFindings(run, 'matrix', sorted, engine.corpus.live.length, matrixJson(report));\n}\n\n/**\n * The waves, computed. The view shows the moves, their reasons and the\n * cycles; the other findings - briefs that run alone, pairs the search could\n * not decide, a front matter that cannot take a wave - print beneath it.\n */\nasync function runSchedule(run: Run): Promise<number> {\n  const engine = await openEngine(run);\n  engine.requireBriefs();\n  const { schedule: computed, findings } = await engine.schedule();\n  let written: string[] | null = null;\n  let reported: Finding[] = findings;\n  if (flag(run.values, 'write')) {\n    const result = await engine.writeWaves(computed);\n    written = result.written;\n    // Written, the waves hold, and the findings that said they did not are answered.\n    reported = [...(written.length > 0 ? findings.filter((f) => f.rule !== 'wave-schedule') : findings), ...result.refused];\n  }\n  const sorted = sortFindings(reported);\n  if (run.format === 'pretty') {\n    run.out(`${prettySchedule(computed, written, run.style)}\\n`);\n    const rest = sorted.filter((f) => f.rule !== 'wave-schedule' && f.rule !== 'dependency-cycle');\n    if (rest.length > 0) run.out(`\\n${prettyFindings(rest, run.style)}\\n`);\n    return failing(sorted, run.strict) ? EXIT_FAILED : EXIT_OK;\n  }\n  return emitFindings(run, 'schedule', sorted, engine.corpus.live.length, { ...scheduleJson(computed), written });\n}\n\nasync function runTransition(run: Run, action: 'archive' | 'unarchive'): Promise<number> {\n  const reference = run.positionals[0];\n  if (reference === undefined || run.positionals.length > 1) throw new UsageError(`${action} takes one brief: spec-brief ${action} <brief>`);\n  const engine = await openEngine(run);\n  const dryRun = flag(run.values, 'dry-run');\n  const plan: Plan =\n    action === 'archive'\n      ? await engine.planArchive(reference, {\n          pr: integer(run.values, 'pr', 1),\n          commit: text(run.values, 'commit'),\n          base: text(run.values, 'base'),\n          summary: text(run.values, 'summary'),\n          date: text(run.values, 'date') ?? run.today,\n          allowDirty: flag(run.values, 'allow-dirty'),\n          strict: run.strict,\n          noGit: flag(run.values, 'no-git'),\n        })\n      : engine.planUnarchive(reference, { strict: run.strict });\n  const refused = plan.blocking.length > 0;\n  if (!refused && !dryRun) await engine.apply(plan);\n  if (run.format === 'json') run.out(jsonDocument(action, run.version, { ok: !refused, dryRun, plan: planJson(plan) }));\n  else run.out(`${prettyPlan(plan, dryRun, run.style)}\\n`);\n  return refused ? EXIT_FAILED : EXIT_OK;\n}\n\nexport async function main(argv: readonly string[] = process.argv.slice(2), io: CliIO = {}): Promise<number> {\n  const stdout = io.stdout ?? process.stdout;\n  const stderr = io.stderr ?? process.stderr;\n  const err = (message: string): void => {\n    stderr.write(`spec-brief: ${message}\\n`);\n  };\n  let parsed: Parsed;\n  try {\n    parsed = parse(argv);\n  } catch (error) {\n    err((error as Error).message);\n    return EXIT_ERROR;\n  }\n  const { command, values, positionals } = parsed;\n  // From here on, so that what comes before a command is covered as the\n  // command is: --version and --help, the package's own manifest, the date.\n  // An error there left main as a rejection, which the launcher ended as\n  // Node's uncaught error with exit 1, \"findings\" to a script.\n  try {\n    if (flag(values, 'version')) {\n      stdout.write(`${await version()}\\n`);\n      return EXIT_OK;\n    }\n    if (flag(values, 'help') || command === undefined) {\n      stdout.write(HELP);\n      // Asked for, the help is the answer; printed because no command was named, it is the error.\n      return flag(values, 'help') ? EXIT_OK : EXIT_ERROR;\n    }\n    const spec = COMMANDS.get(command) as CommandSpec;\n    const format = (text(values, 'format') ?? 'pretty') as Format;\n    if (!spec.formats.includes(format)) {\n      err(`--format for ${command} is one of ${spec.formats.join(', ')}, not \"${format}\"`);\n      return EXIT_ERROR;\n    }\n    const run: Run = {\n      today: today(io.env ?? process.env),\n      out: (t) => {\n        stdout.write(t);\n      },\n      err,\n      // Read by the pretty format alone: the others have nothing to colour.\n      style: { color: useColor(values, io) },\n      format,\n      strict: flag(values, 'strict'),\n      version: await version(),\n      values,\n      positionals,\n      cwd: io.cwd ?? process.cwd(),\n    };\n    switch (command) {\n      case 'init':\n        return await runInit(run);\n      case 'new':\n        return await runNew(run);\n      case 'lint':\n        return await runLint(run);\n      case 'list':\n        return await runList(run);\n      case 'matrix':\n        return await runMatrix(run);\n      case 'schedule':\n        return await runSchedule(run);\n      case 'archive':\n        return await runTransition(run, 'archive');\n      default:\n        return await runTransition(run, 'unarchive');\n    }\n  } catch (error) {\n    // What git refused or could not do is git's message, and no line here.\n    const expected = [ConfigError, UsageError, EngineError, ConflictError, TransactionError, GitError];\n    if (expected.some((kind) => error instanceof kind)) {\n      err((error as Error).message);\n      return EXIT_ERROR;\n    }\n    // A write its reader had closed the pipe for is no defect either: the\n    // answer was not delivered, which is still 2, and no stack sends a person\n    // looking for a bug. The process's own streams report it as an event,\n    // which the launcher answers in the same words; here it is a caller's\n    // stream that throws it. It is read by its code: stdout and stderr are the\n    // only pipes spec-brief writes to.\n    if (!(error instanceof Error)) err(`unexpected error: ${String(error)}`);\n    else if ((error as NodeJS.ErrnoException).code === 'EPIPE') err('stdout was closed before all of the output was written');\n    else err(`unexpected error: ${error.stack ?? error.message}`);\n    return EXIT_ERROR;\n  }\n}\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The command line: argument parsing, dispatch, output and exit codes.\n *\n * Exit 0: done, nothing found. Exit 1: findings, collisions, or an action\n * refused. Exit 2: the run could not be trusted - a bad flag, a configuration\n * that does not load, a brief that does not exist. A run that checked nothing\n * must never exit as though it found nothing.\n */\n\nimport { readFile, stat } from 'node:fs/promises';\nimport { parseArgs, type ParseArgsConfig } from 'node:util';\n\nimport { TransactionError, ConflictError } from './apply.js';\nimport type { Plan } from './archive.js';\nimport { reported } from './collisions.js';\nimport { CONFIG_FILES, ConfigError, initialConfig } from './config.js';\nimport { BriefEngine, EngineError, today } from './engine.js';\nimport { NodeFileSystem } from './fs.js';\nimport { GitError } from './git.js';\nimport { failing, sortFindings, summarise } from './lint.js';\nimport { normalisePath } from './links.js';\nimport {\n  briefJson,\n  findingJson,\n  FORMATS,\n  type Format,\n  githubCommands,\n  gitlabCodeQuality,\n  jsonDocument,\n  type ListRow,\n  matrixJson,\n  planJson,\n  prettyFindings,\n  prettyList,\n  prettyMatrix,\n  prettyPlan,\n  prettySchedule,\n  sarif,\n  scheduleJson,\n  sectionsJson,\n  type Style,\n  summaryLine,\n} from './report.js';\nimport type { Finding } from './types.js';\n\nexport const EXIT_OK = 0;\nexport const EXIT_FAILED = 1;\nexport const EXIT_ERROR = 2;\n\nexport class UsageError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'UsageError';\n  }\n}\n\nexport interface CliIO {\n  readonly stdout?: { write(text: string): unknown; readonly isTTY?: boolean };\n  readonly stderr?: { write(text: string): unknown };\n  readonly cwd?: string;\n  readonly env?: Readonly<Record<string, string | undefined>>;\n}\n\ntype Values = Record<string, string | boolean | undefined>;\n\nconst GLOBAL: NonNullable<ParseArgsConfig['options']> = {\n  root: { type: 'string' },\n  config: { type: 'string' },\n  'no-config': { type: 'boolean' },\n  format: { type: 'string' },\n  strict: { type: 'boolean' },\n  'no-git': { type: 'boolean' },\n  color: { type: 'boolean' },\n  'no-color': { type: 'boolean' },\n  help: { type: 'boolean', short: 'h' },\n  version: { type: 'boolean', short: 'v' },\n};\n\ninterface CommandSpec {\n  readonly options: NonNullable<ParseArgsConfig['options']>;\n  readonly formats: readonly Format[];\n  /**\n   * Set on a command that takes no argument: what its refusal of one adds to\n   * the usage, which is where the option a person most likely meant is named.\n   */\n  readonly noArgument?: string;\n}\n\nconst TABLE: Readonly<Record<string, CommandSpec>> = {\n  init: {\n    options: { briefs: { type: 'string' }, archive: { type: 'string' } },\n    formats: ['pretty', 'json'],\n    noArgument: '; --root <dir> names the directory it sets up, and --briefs <dir> the one for the briefs',\n  },\n  new: {\n    options: {\n      id: { type: 'string' },\n      type: { type: 'string' },\n      wave: { type: 'string' },\n      'depends-on': { type: 'string' },\n      date: { type: 'string' },\n    },\n    formats: ['pretty', 'json'],\n  },\n  lint: { options: {}, formats: FORMATS },\n  list: { options: { ready: { type: 'boolean' }, archived: { type: 'boolean' } }, formats: ['pretty', 'json'], noArgument: '' },\n  matrix: { options: { 'all-waves': { type: 'boolean' } }, formats: FORMATS, noArgument: '' },\n  schedule: { options: { write: { type: 'boolean' } }, formats: FORMATS, noArgument: '' },\n  archive: {\n    options: {\n      pr: { type: 'string' },\n      commit: { type: 'string' },\n      base: { type: 'string' },\n      summary: { type: 'string' },\n      date: { type: 'string' },\n      'allow-dirty': { type: 'boolean' },\n      'dry-run': { type: 'boolean' },\n    },\n    formats: ['pretty', 'json'],\n  },\n  unarchive: { options: { 'dry-run': { type: 'boolean' } }, formats: ['pretty', 'json'] },\n};\n\n/**\n * Whether taking the option would tell someone what is not so. `init\n * --strict` says the briefs were set up strictly, where nothing was strict;\n * `init --config team.json` that the configuration was written there, where\n * `.spec-brief.json` was; `init --color` and `new --color` that colour was\n * printed, where neither prints any; `new --strict` and `list --strict` that\n * a warning would have failed the run, where neither has one. Each ran as\n * the line without the option does, exit 0.\n *\n * A function, not a table beside the commands': a table built when the\n * module loads is static to Stryker, and each of its mutants then runs the\n * whole suite (ADR-0009).\n */\nfunction untrue(command: string, option: string): boolean {\n  switch (option) {\n    case 'config':\n      return command === 'init';\n    case 'strict':\n      return command === 'init' || command === 'new' || command === 'list';\n    case 'color':\n      return command === 'init' || command === 'new';\n    // Each caller asks only whether the answer is true, so the mutant that\n    // leaves this case out, and answers nothing, is equivalent.\n    default:\n      return false;\n  }\n}\n\n/**\n * Whether the option asks the command to leave out what it never does, and\n * so asks for what is already so: `init` opens no configuration file and\n * asks git nothing, and neither it nor `new` prints colour. Such an option\n * is taken. A script that runs every command in a tree without git, or into\n * a log, passes it to each of them, as spec-harness passes `--no-color`.\n * The command reads nothing of it, so a refusal's line lists it apart from\n * what the command reads, as taken.\n */\nfunction alreadySo(command: string, option: string): boolean {\n  switch (option) {\n    case 'no-config':\n    case 'no-git':\n      return command === 'init';\n    case 'no-color':\n      return command === 'init' || command === 'new';\n    // Each caller asks only whether the answer is true, so the mutant that\n    // leaves this case out, and answers nothing, is equivalent.\n    default:\n      return false;\n  }\n}\n\n/** Options by their names on the command line, as a sentence lists them. */\nfunction listed(names: readonly string[]): string {\n  const options = names.map((name) => `--${name}`);\n  return options.length === 1 ? (options[0] as string) : `${options.slice(0, -1).join(', ')} and ${options.at(-1) as string}`;\n}\n\n/**\n * Why a command line that parsed is still not one to run.\n *\n * An option is refused where taking it would tell someone what is not so,\n * and so are two options of which one would go unread: `--config team.json\n * --no-config` says the file was read, where the defaults ran, and `--color\n * --no-color` that colour was forced on, where it was off. An option that\n * asks a command to leave out what it never does asks for what is already\n * so, and is taken.\n */\nfunction unread(command: string, spec: CommandSpec, values: Values): string | null {\n  // The first such option as the line was typed, which is the order the\n  // parser keeps.\n  const stray = Object.keys(values).find((option) => untrue(command, option));\n  if (stray !== undefined) {\n    const shared = Object.keys(GLOBAL).filter((option) => option !== 'help' && option !== 'version' && !untrue(command, option));\n    const reads = [...shared.filter((option) => !alreadySo(command, option)), ...Object.keys(spec.options)];\n    const takes = shared.filter((option) => alreadySo(command, option));\n    return `${command} does not read --${stray}; it reads ${listed(reads)}${takes.length > 0 ? `, and takes ${listed(takes)}` : ''}`;\n  }\n  if (text(values, 'config') !== undefined && flag(values, 'no-config')) {\n    return '--config is given beside --no-config, which has the run read no configuration file; give one of the two';\n  }\n  if (flag(values, 'color') && flag(values, 'no-color')) return '--color is given beside --no-color, which turns colour off; give one of the two';\n  return null;\n}\n\n/**\n * The commands by name, and nothing for a command line that names none. A map,\n * because an object answers to more names than it was given: `constructor` and\n * `toString` are no commands.\n */\nconst COMMANDS: ReadonlyMap<string | undefined, CommandSpec> = new Map(Object.entries(TABLE));\n\n/**\n * The formats each command writes, read from the table `main` checks a\n * `--format` against, so the help names no format a command refuses: the\n * finding formats are `lint`'s, `matrix`'s and `schedule`'s alone.\n */\nfunction formatsHelp(): string {\n  const groups = new Map<string, string[]>();\n  for (const [command, spec] of Object.entries(TABLE)) {\n    const formats = spec.formats.join(', ');\n    groups.set(formats, [...(groups.get(formats) ?? []), command]);\n  }\n  const rows = [...groups].map(([formats, commands]) => [commands.join(', '), formats] as const);\n  const width = Math.max(...rows.map(([commands]) => commands.length));\n  return rows.map(([commands, formats]) => `  ${commands.padEnd(width)}  ${formats}`).join('\\n');\n}\n\nexport const HELP = `spec-brief - lint, schedule and archive task briefs\n\nUsage:\n  spec-brief <command> [options]\n\nCommands:\n  init                  write .spec-brief.json and the brief directories\n  new <title>           scaffold a brief with the next free id\n  lint [brief...]       check briefs against the configuration\n  list                  briefs with their status, wave and readiness\n  matrix                scope collisions between briefs in the same wave\n  schedule              the waves the live briefs can run in, computed\n  archive <brief>       close a round: check it, stamp it, freeze it, move it\n  unarchive <brief>     reopen an archived brief\n\nOptions for every command, except where a line says otherwise:\n  --root <dir>          run from this directory instead of the current one; it must exist, unless init makes it\n  --config <file>       use this configuration file; not for init, which writes .spec-brief.json\n  --no-config           use the defaults, ignoring any configuration file\n  --format <format>     the output format, pretty by default; each command's are below\n  --strict              treat warnings as errors; not for init, new or list, which have none\n  --no-git              leave git out; read the files on disk instead\n  --color, --no-color   force colour on or off; --color not for init or new, which print none\n  -h, --help            show this help\n  -v, --version         show the version\n\nFormats:\n${formatsHelp()}\n\ninit:\n  --briefs <dir>        the directory of live briefs; default briefs\n  --archive <dir>       the directory of archived briefs; default <briefs>/archive\n\nnew:\n  --id <id>             use this id instead of the next free one\n  --type <type>         a brief type from the configuration\n  --wave <n>            the wave it runs in\n  --depends-on <ids>    comma-separated ids it runs after\n  --date <YYYY-MM-DD>   the date in its front matter; default SOURCE_DATE_EPOCH's, or today's in UTC\n\nlist:\n  --ready               only briefs that can run now: dependencies archived, not drafts or deferred\n  --archived            include archived briefs\n\nmatrix:\n  --all-waves           compare every live brief, whatever its wave\n\nschedule:\n  --write               write each proposed wave into its brief's front matter\n\narchive:\n  --pr <number>         the pull request the round merged in\n  --commit <rev>        the commit the round landed as\n  --base <rev>          the branch it started from; the diff runs from the merge base\n  --summary <text>      what the round did, for the banner\n  --date <YYYY-MM-DD>   the archival date; default SOURCE_DATE_EPOCH's, or today's in UTC\n  --allow-dirty         archive although the tree has uncommitted work\n  --dry-run             print the plan and change nothing\n\nunarchive:\n  --dry-run             print the plan and change nothing\n\nAn option given an empty value, a list that names nothing and an argument a\ncommand does not take are refused, not read as if they were not there. So is\nan option where taking it would say what is not so, as init --strict, and so\nare --config beside --no-config and --color beside --no-color, of which one\nwould go unread. An option that asks a command to leave out what it never\ndoes is taken, as init --no-git: it asks for what is already so.\n\nExit codes: 0 clean, 1 findings or refused, 2 the run could not be trusted.\n`;\n\ninterface Parsed {\n  readonly command: string | undefined;\n  readonly values: Values;\n  readonly positionals: readonly string[];\n}\n\n/** Global options that take a value, so the value is not mistaken for the command. */\nconst VALUED = new Set(['--root', '--config', '--format']);\n\nfunction commandOf(argv: readonly string[]): string | undefined {\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i] as string;\n    if (arg === '--') return argv[i + 1];\n    if (VALUED.has(arg)) {\n      i += 1;\n      continue;\n    }\n    if (!arg.startsWith('-')) return arg;\n  }\n  return undefined;\n}\n\nexport function parse(argv: readonly string[]): Parsed {\n  const command = commandOf(argv);\n  const spec = COMMANDS.get(command);\n  if (command !== undefined && spec === undefined) {\n    throw new UsageError(`\"${command}\" is not a command; run spec-brief --help`);\n  }\n  let parsed: { values: Values; positionals: string[] };\n  try {\n    parsed = parseArgs({\n      args: [...argv],\n      options: { ...GLOBAL, ...(spec?.options ?? {}) },\n      allowPositionals: true,\n      strict: true,\n    }) as { values: Values; positionals: string[] };\n  } catch (error) {\n    throw new UsageError((error as Error).message);\n  }\n  const positionals = parsed.positionals.slice(1);\n  // What the parser takes is not yet what names something. An option whose\n  // value is empty, as `--root \"$DIR\"` is where the variable is not set, was\n  // read as the option left out, and an argument no command asked for was\n  // dropped: either way the run answered a question nobody had put, exit 0.\n  for (const [name, value] of Object.entries(parsed.values)) {\n    if (typeof value === 'string' && value.trim() === '') {\n      // Shown as JSON, where a tab or a line break in it can be seen.\n      throw new UsageError(`--${name} is ${JSON.stringify(value)}, which is no value; give it one, or leave the option out`);\n    }\n  }\n  if (spec?.noArgument !== undefined && positionals.length > 0) {\n    const extra = positionals.map((argument) => `\"${argument}\"`).join(', ');\n    throw new UsageError(`${command} takes no argument, not ${extra}: spec-brief ${command}${spec.noArgument}`);\n  }\n  return { command, values: parsed.values, positionals };\n}\n\n/** The value of an option declared a string, which is all `parseArgs` gives one. */\nfunction text(values: Values, key: string): string | undefined {\n  return values[key] as string | undefined;\n}\n\nfunction flag(values: Values, key: string): boolean {\n  return values[key] === true;\n}\n\nfunction integer(values: Values, key: string, minimum: number): number | undefined {\n  const raw = text(values, key);\n  if (raw === undefined) return undefined;\n  if (!/^\\d+$/.test(raw) || Number(raw) < minimum) throw new UsageError(`--${key} must be a whole number of at least ${minimum}, not \"${raw}\"`);\n  return Number(raw);\n}\n\nasync function version(): Promise<string> {\n  const pkg = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8')) as { version: string };\n  return pkg.version;\n}\n\ninterface Run {\n  /**\n   * Today, as the environment the run was given says. Asked only by a command\n   * that writes a date and was given none: a `SOURCE_DATE_EPOCH` that cannot\n   * be read stops the run that would have written the clock's date for it,\n   * and no run whose answer it has no part in.\n   */\n  readonly today: () => string;\n  readonly out: (text: string) => void;\n  readonly err: (text: string) => void;\n  readonly style: Style;\n  readonly format: Format;\n  readonly strict: boolean;\n  readonly version: string;\n  readonly values: Values;\n  readonly positionals: readonly string[];\n  readonly cwd: string;\n}\n\nfunction useColor(values: Values, io: CliIO): boolean {\n  if (flag(values, 'no-color')) return false;\n  if (flag(values, 'color')) return true;\n  const env = io.env ?? process.env;\n  if ((env['NO_COLOR'] ?? '') !== '') return false;\n  // Off for exactly \"0\" and exactly \"false\": Node itself and supports-color\n  // read \"false\" as off, and here it forced colour on. Any other value that\n  // is not empty is on, \"FALSE\" too, which is the one reading the family's\n  // tools share (spec-core ADR-0005).\n  const force = env['FORCE_COLOR'];\n  if (force !== undefined && force !== '') return force !== '0' && force !== 'false';\n  // A terminal that says it is dumb has asked for no escape sequence, and\n  // Node itself counts one colour for it: the family's tools read it alike.\n  if (env['TERM'] === 'dumb') return false;\n  return (io.stdout ?? process.stdout).isTTY === true;\n}\n\nasync function openEngine(run: Run): Promise<BriefEngine> {\n  return BriefEngine.open({\n    cwd: text(run.values, 'root') ?? run.cwd,\n    config: text(run.values, 'config'),\n    ...(flag(run.values, 'no-git') ? { git: null } : {}),\n    noConfig: flag(run.values, 'no-config'),\n  });\n}\n\nfunction emitFindings(run: Run, command: string, findings: readonly Finding[], checked: number, extra: Record<string, unknown> = {}): number {\n  const failed = failing(findings, run.strict);\n  switch (run.format) {\n    case 'json':\n      run.out(jsonDocument(command, run.version, { ok: !failed, checked, summary: summarise(findings), findings: findings.map(findingJson), ...extra }));\n      break;\n    case 'sarif':\n      run.out(sarif(findings, run.version));\n      break;\n    case 'github':\n      run.out(githubCommands(findings));\n      break;\n    case 'gitlab':\n      run.out(gitlabCodeQuality(findings));\n      break;\n    case 'pretty':\n      if (findings.length > 0) run.out(`${prettyFindings(findings, run.style)}\\n\\n`);\n      run.out(`${findings.length === 0 ? `${checked} brief(s) checked, no findings` : `${summaryLine(findings)} in ${checked} brief(s)`}\\n`);\n      break;\n  }\n  return failed ? EXIT_FAILED : EXIT_OK;\n}\n\nasync function runInit(run: Run): Promise<number> {\n  const root = text(run.values, 'root') ?? run.cwd;\n  const fs = new NodeFileSystem(root);\n  for (const name of CONFIG_FILES) {\n    if (await fs.exists(name)) throw new UsageError(`${name} already exists here; edit it instead`);\n  }\n  // A directory above the root is refused as the configuration refuses one\n  // (config.ts), in the same words, before anything is written.\n  const inside = (option: string, given: string): string => {\n    try {\n      return normalisePath(given);\n    } catch {\n      throw new UsageError(`--${option} must be a directory inside the repository, not \"${given}\"`);\n    }\n  };\n  const briefs = inside('briefs', text(run.values, 'briefs') ?? 'briefs');\n  const archive = inside('archive', text(run.values, 'archive') ?? `${briefs}/archive`);\n  if (briefs === '' || archive === '' || briefs === archive) throw new UsageError('--briefs and --archive must be two directories');\n  const config = `${JSON.stringify(initialConfig(briefs, archive), null, 2)}\\n`;\n  await fs.write('.spec-brief.json', config);\n  const written = ['.spec-brief.json'];\n  for (const dir of [briefs, archive]) {\n    const keep = `${dir}/.gitkeep`;\n    if ((await fs.list(dir)) === null) {\n      await fs.write(keep, '');\n      written.push(keep);\n    }\n  }\n  if (run.format === 'json') run.out(jsonDocument('init', run.version, { ok: true, written }));\n  else run.out(`${written.map((w) => `wrote ${w}`).join('\\n')}\\nnext: spec-brief new \"<title>\"\\n`);\n  return EXIT_OK;\n}\n\nasync function runNew(run: Run): Promise<number> {\n  const title = run.positionals.join(' ').trim();\n  if (title === '') throw new UsageError('new needs a title: spec-brief new \"<title>\"');\n  const listed = text(run.values, 'depends-on');\n  const dependsOn = listed?.split(',').map((d) => d.trim());\n  // A list that names no brief is not a brief that depends on none: written\n  // as given, \",\" scaffolded a brief with no dependency and said nothing.\n  if (dependsOn?.every((d) => d === '')) {\n    throw new UsageError(`--depends-on is ${JSON.stringify(listed)}, which names no brief; give it ids with commas between them, as in 7,8, or leave the option out`);\n  }\n  // And a place in it that names none is a brief left out: \"$A,$B\" with one\n  // of the two unset scaffolded a brief that depends on the other alone.\n  if (dependsOn?.includes('')) {\n    throw new UsageError(`--depends-on is ${JSON.stringify(listed)}, which names no brief in one of its places; give it ids with one comma between each two, as in 7,8, and none before or after`);\n  }\n  const engine = await openEngine(run);\n  const created = await engine.create({\n    title,\n    id: text(run.values, 'id'),\n    type: text(run.values, 'type'),\n    wave: integer(run.values, 'wave', 0),\n    dependsOn,\n    date: text(run.values, 'date') ?? run.today(),\n  });\n  if (run.format === 'json') run.out(jsonDocument('new', run.version, { ok: true, file: created.file }));\n  else run.out(`wrote ${created.file}\\n`);\n  return EXIT_OK;\n}\n\nasync function runLint(run: Run): Promise<number> {\n  const engine = await openEngine(run);\n  engine.requireBriefs();\n  const findings = await engine.lint(run.positionals);\n  const checked = run.positionals.length === 0 ? engine.corpus.briefs.length : run.positionals.length;\n  return emitFindings(run, 'lint', findings, checked, { sections: sectionsJson(engine.config) });\n}\n\nasync function runList(run: Run): Promise<number> {\n  const engine = await openEngine(run);\n  engine.requireBriefs();\n  const briefs = flag(run.values, 'archived') ? engine.corpus.briefs : engine.corpus.live;\n  const ready = new Set(engine.ready());\n  const rows: ListRow[] = briefs\n    .map((brief) => ({ brief, ready: ready.has(brief), waitingOn: engine.waitingOn(brief) }))\n    .filter((row) => !flag(run.values, 'ready') || row.ready);\n  if (run.format === 'json') {\n    run.out(\n      jsonDocument('list', run.version, {\n        ok: true,\n        briefs: rows.map((r) => briefJson(r.brief, { ready: r.ready, waitingOn: r.waitingOn })),\n        sections: sectionsJson(engine.config),\n      }),\n    );\n  } else {\n    run.out(`${prettyList(rows, run.style)}\\n`);\n  }\n  return EXIT_OK;\n}\n\nasync function runMatrix(run: Run): Promise<number> {\n  const engine = await openEngine(run);\n  engine.requireBriefs();\n  const { report, findings } = await engine.collisions({ all: flag(run.values, 'all-waves') });\n  const sorted = sortFindings(findings);\n  if (run.format === 'pretty') {\n    // Drawn from what the run reports, so a rule that is off marks nothing in the grid.\n    run.out(`${prettyMatrix(reported(engine.corpus, report), run.style)}\\n`);\n    return failing(sorted, run.strict) ? EXIT_FAILED : EXIT_OK;\n  }\n  return emitFindings(run, 'matrix', sorted, engine.corpus.live.length, matrixJson(report));\n}\n\n/**\n * The waves, computed. The view shows the moves, their reasons and the\n * cycles; the other findings - briefs that run alone, pairs the search could\n * not decide, a front matter that cannot take a wave - print beneath it.\n */\nasync function runSchedule(run: Run): Promise<number> {\n  const engine = await openEngine(run);\n  engine.requireBriefs();\n  const { schedule: computed, findings } = await engine.schedule();\n  let written: string[] | null = null;\n  let reported: Finding[] = findings;\n  if (flag(run.values, 'write')) {\n    const result = await engine.writeWaves(computed);\n    written = result.written;\n    // Written, the waves hold, and the findings that said they did not are answered.\n    reported = [...(written.length > 0 ? findings.filter((f) => f.rule !== 'wave-schedule') : findings), ...result.refused];\n  }\n  const sorted = sortFindings(reported);\n  if (run.format === 'pretty') {\n    run.out(`${prettySchedule(computed, written, run.style)}\\n`);\n    const rest = sorted.filter((f) => f.rule !== 'wave-schedule' && f.rule !== 'dependency-cycle');\n    if (rest.length > 0) run.out(`\\n${prettyFindings(rest, run.style)}\\n`);\n    return failing(sorted, run.strict) ? EXIT_FAILED : EXIT_OK;\n  }\n  return emitFindings(run, 'schedule', sorted, engine.corpus.live.length, { ...scheduleJson(computed), written });\n}\n\nasync function runTransition(run: Run, action: 'archive' | 'unarchive'): Promise<number> {\n  const reference = run.positionals[0];\n  if (reference === undefined || run.positionals.length > 1) throw new UsageError(`${action} takes one brief: spec-brief ${action} <brief>`);\n  const engine = await openEngine(run);\n  const dryRun = flag(run.values, 'dry-run');\n  const plan: Plan =\n    action === 'archive'\n      ? await engine.planArchive(reference, {\n          pr: integer(run.values, 'pr', 1),\n          commit: text(run.values, 'commit'),\n          base: text(run.values, 'base'),\n          summary: text(run.values, 'summary'),\n          date: text(run.values, 'date') ?? run.today(),\n          allowDirty: flag(run.values, 'allow-dirty'),\n          strict: run.strict,\n          noGit: flag(run.values, 'no-git'),\n        })\n      : engine.planUnarchive(reference, { strict: run.strict });\n  const refused = plan.blocking.length > 0;\n  if (!refused && !dryRun) await engine.apply(plan);\n  if (run.format === 'json') run.out(jsonDocument(action, run.version, { ok: !refused, dryRun, plan: planJson(plan) }));\n  else run.out(`${prettyPlan(plan, dryRun, run.style)}\\n`);\n  return refused ? EXIT_FAILED : EXIT_OK;\n}\n\nexport async function main(argv: readonly string[] = process.argv.slice(2), io: CliIO = {}): Promise<number> {\n  const stdout = io.stdout ?? process.stdout;\n  const stderr = io.stderr ?? process.stderr;\n  const err = (message: string): void => {\n    stderr.write(`spec-brief: ${message}\\n`);\n  };\n  let parsed: Parsed;\n  try {\n    parsed = parse(argv);\n  } catch (error) {\n    err((error as Error).message);\n    return EXIT_ERROR;\n  }\n  const { command, values, positionals } = parsed;\n  // From here on, so that what comes before a command is covered as the\n  // command is: --version and --help, the package's own manifest, the colour.\n  // An error there left main as a rejection, which the launcher ended as\n  // Node's uncaught error with exit 1, \"findings\" to a script.\n  try {\n    if (flag(values, 'version')) {\n      stdout.write(`${await version()}\\n`);\n      return EXIT_OK;\n    }\n    if (flag(values, 'help') || command === undefined) {\n      stdout.write(HELP);\n      // Asked for, the help is the answer; printed because no command was named, it is the error.\n      return flag(values, 'help') ? EXIT_OK : EXIT_ERROR;\n    }\n    const spec = COMMANDS.get(command) as CommandSpec;\n    const refusal = unread(command, spec, values);\n    if (refusal !== null) throw new UsageError(refusal);\n    const format = (text(values, 'format') ?? 'pretty') as Format;\n    if (!spec.formats.includes(format)) {\n      err(`--format for ${command} is one of ${spec.formats.join(', ')}, not \"${format}\"`);\n      return EXIT_ERROR;\n    }\n    // A file, or a name with nothing behind it, had the search for a\n    // configuration go on from its parent: the run reported on a tree nobody\n    // had named, and `new` wrote into it. A path that cannot be reached is\n    // not there to the run either. `init` alone is given a directory that\n    // does not exist yet, which it makes.\n    const root = text(values, 'root');\n    if (root !== undefined) {\n      const found = await stat(root).catch(() => null);\n      if (found === null ? command !== 'init' : !found.isDirectory()) {\n        throw new UsageError(`--root is \"${root}\", which is no directory; give it one, or leave the option out`);\n      }\n    }\n    const run: Run = {\n      today: () => today(io.env ?? process.env),\n      out: (t) => {\n        stdout.write(t);\n      },\n      err,\n      // Read by the pretty format alone: the others have nothing to colour.\n      style: { color: useColor(values, io) },\n      format,\n      strict: flag(values, 'strict'),\n      version: await version(),\n      values,\n      positionals,\n      cwd: io.cwd ?? process.cwd(),\n    };\n    switch (command) {\n      case 'init':\n        return await runInit(run);\n      case 'new':\n        return await runNew(run);\n      case 'lint':\n        return await runLint(run);\n      case 'list':\n        return await runList(run);\n      case 'matrix':\n        return await runMatrix(run);\n      case 'schedule':\n        return await runSchedule(run);\n      case 'archive':\n        return await runTransition(run, 'archive');\n      default:\n        return await runTransition(run, 'unarchive');\n    }\n  } catch (error) {\n    // What git refused or could not do is git's message, and no line here.\n    const expected = [ConfigError, UsageError, EngineError, ConflictError, TransactionError, GitError];\n    if (expected.some((kind) => error instanceof kind)) {\n      err((error as Error).message);\n      return EXIT_ERROR;\n    }\n    // A write its reader had closed the pipe for is no defect either: the\n    // answer was not delivered, which is still 2, and no stack sends a person\n    // looking for a bug. The process's own streams report it as an event,\n    // which the launcher answers in the same words; here it is a caller's\n    // stream that throws it. It is read by its code: stdout and stderr are the\n    // only pipes spec-brief writes to.\n    if (!(error instanceof Error)) err(`unexpected error: ${String(error)}`);\n    else if ((error as NodeJS.ErrnoException).code === 'EPIPE') err('stdout was closed before all of the output was written');\n    else err(`unexpected error: ${error.stack ?? error.message}`);\n    return EXIT_ERROR;\n  }\n}\n"]}

package/dist/config.js

@@ -339,7 +339,11 @@ export function parseConfig(text, file) {
         raw = JSON.parse(text.charCodeAt(0) === 0xfeff ? text.slice(1) : text);
     }
     catch (error) {
-        throw new ConfigError(file, [`is not valid JSON (${error.message})`]);
+        // The parser quotes what it could not read. A line break quoted from the
+        // file made this refusal two lines, and any other control character was
+        // handed to the terminal: each is written as its escape.
+        const said = error.message.replace(/[\u0000-\u001f\u007f-\u009f]/g, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+        throw new ConfigError(file, [`is not valid JSON (${said})`]);
     }
     return resolveConfig(raw, file);
 }

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Configuration: what it may say, what it says when it says nothing, and how a\n * file becomes a `Config`.\n *\n * Every repository that already keeps briefs keeps them its own way - where\n * they live, what the sections are called, which word means \"done\" - so the\n * conventions are data here rather than code. The defaults describe a brief\n * with the four parts every round needs: an intent, a negative scope, what the\n * round is not empowered to touch, and the invariants that prove it is done.\n *\n * A configuration that does not load stops the run. A typo that silently\n * falls back to defaults produces a clean-looking report about the wrong\n * rules, which is worse than no report.\n */\n\nimport { dirname, join } from 'node:path';\n\nimport { parseGlob } from './glob.js';\nimport { normalisePath } from './links.js';\nimport { type Schema, toJsonSchema, validate } from './schema.js';\nimport { inWords, templateHoles } from './text.js';\nimport type { SeveritySetting } from './types.js';\n\nexport interface SectionRule {\n  readonly name: string;\n  readonly aliases: readonly string[];\n  /** Literal text the section must contain, compared exactly. */\n  readonly mustContain: readonly string[];\n  /** The section must hold at least one task item. */\n  readonly checklist: boolean;\n  readonly optional: boolean;\n  /**\n   * What the section must answer. A new brief carries it as a comment under\n   * the heading, a finding that the section is missing or unwritten carries it\n   * as its hint, and `list` and `lint` report it, so a tool that helps write a\n   * brief can ask for each section without knowing its name in advance.\n   */\n  readonly hint?: string | undefined;\n}\n\nexport interface PluginReference {\n  readonly module: string;\n  readonly options: unknown;\n}\n\nexport interface Config {\n  /** Directory of live briefs, relative to the root. */\n  readonly briefs: string;\n  /** Directory of archived briefs, relative to the root. */\n  readonly archive: string;\n  /** Glob a file name must match to be a brief. */\n  readonly files: string;\n  /** File-name globs that are never briefs, such as an index. */\n  readonly exclude: readonly string[];\n  /** A template for `new`, relative to the root; `null` builds one from `sections`. */\n  readonly template: string | null;\n  readonly id: {\n    readonly source: 'filename' | 'frontmatter';\n    readonly separator: string;\n    readonly digits: number;\n  };\n  readonly status: {\n    readonly field: string | null;\n    readonly draft: string | null;\n    readonly active: string;\n    /** The word for work put off until an event its `trigger` names; `null` when a repository has none. */\n    readonly deferred: string | null;\n    readonly archived: string;\n  };\n  readonly sections: readonly SectionRule[];\n  readonly sectionOrder: boolean;\n  readonly types: Readonly<Record<string, readonly SectionRule[]>>;\n  readonly placeholders: readonly string[];\n  readonly fields: readonly string[];\n  readonly archiving: {\n    readonly tasks: 'all' | readonly string[];\n    readonly dispositions: readonly string[];\n    readonly banner: readonly string[];\n    readonly rewriteLinks: boolean;\n    readonly freeze: boolean;\n    readonly base: string | null;\n  };\n  readonly rules: Readonly<Record<string, SeveritySetting>>;\n  readonly plugins: readonly PluginReference[];\n}\n\nexport const CONFIG_FILES: readonly string[] = ['.spec-brief.json', 'spec-brief.json'];\n\n/** The holes a banner line may use. */\nexport const BANNER_PLACEHOLDERS: readonly string[] = [\n  'date',\n  'summary',\n  'pr',\n  'commit',\n  'diffstat',\n  'links',\n  'id',\n  'title',\n  'author',\n];\n\nexport const SCHEMA_URL = 'https://raw.githubusercontent.com/DescentVTT/spec-brief/main/schema.json';\n\n/**\n * The `$schema` `init` writes, the path the README recommends: the schema of\n * the version installed, which is the one that loads the file. `SCHEMA_URL`\n * follows main, and would flag a key the installed version accepts, or pass\n * one it refuses, as soon as the two differ.\n */\nexport const SCHEMA_PATH = './node_modules/@descent-vtt/spec-brief/schema.json';\n\nconst SEVERITY: Schema = { type: 'string', enum: ['off', 'note', 'warning', 'error'] };\nconst STRINGS: Schema = { type: 'array', items: { type: 'string', minLength: 1 } };\n\nconst SECTION: Schema = {\n  type: 'anyOf',\n  description: 'A section name, or a section with aliases and content rules.',\n  options: [\n    { type: 'string', minLength: 1 },\n    {\n      type: 'object',\n      required: ['name'],\n      properties: {\n        name: { type: 'string', minLength: 1, description: 'The heading text, compared without case or punctuation.' },\n        aliases: { ...STRINGS, description: 'Other headings that fill this section.' },\n        mustContain: { ...STRINGS, description: 'Literal text the section must contain.' },\n        checklist: { type: 'boolean', description: 'The section must hold at least one \"- [ ]\" task item.' },\n        optional: { type: 'boolean', description: 'Checked when present, not required.' },\n        hint: {\n          type: 'string',\n          minLength: 1,\n          description: 'What the section must answer: a comment under the heading in a new brief, and the hint of a finding that it is missing or unwritten.',\n        },\n      },\n    },\n  ],\n};\n\nexport const CONFIG_SCHEMA: Schema = {\n  type: 'object',\n  properties: {\n    $schema: { type: 'string' },\n    briefs: { type: 'string', minLength: 1, description: 'Directory of live briefs, relative to this file.' },\n    archive: { type: 'string', minLength: 1, description: 'Directory of archived briefs, relative to this file.' },\n    files: { type: 'string', minLength: 1, description: 'Glob a file name must match to be a brief.' },\n    exclude: { ...STRINGS, description: 'File-name globs that are never briefs.' },\n    template: { type: 'string', nullable: true, description: 'Template file for \"new\"; null builds one from the sections.' },\n    id: {\n      type: 'object',\n      properties: {\n        source: { type: 'string', enum: ['filename', 'frontmatter'], description: 'Where a brief id comes from.' },\n        separator: { type: 'string', minLength: 1, description: 'Separates the id from the slug in a file name.' },\n        digits: { type: 'integer', minimum: 1, maximum: 12, description: 'Width of an allocated numeric id.' },\n      },\n    },\n    status: {\n      type: 'object',\n      properties: {\n        field: { type: 'string', nullable: true, description: 'Front-matter key holding the status; null uses location only.' },\n        draft: { type: 'string', nullable: true, description: 'The word for a brief still being written, or null.' },\n        active: { type: 'string', minLength: 1, description: 'The word for a live brief.' },\n        deferred: {\n          type: 'string',\n          nullable: true,\n          description: 'The word for a live brief put off until the event its \"trigger\" names, or null. A deferred brief is never ready and runs in no wave.',\n        },\n        archived: { type: 'string', minLength: 1, description: 'The word for an archived brief.' },\n      },\n    },\n    sections: { type: 'array', items: SECTION, description: 'Sections every live brief carries.' },\n    sectionOrder: { type: 'boolean', description: 'Sections must appear in the order listed.' },\n    types: {\n      type: 'map',\n      description: 'Brief types, each with the sections it adds.',\n      values: { type: 'object', properties: { sections: { type: 'array', items: SECTION } } },\n    },\n    placeholders: { ...STRINGS, description: 'Words that mark a section as unwritten.' },\n    fields: { ...STRINGS, description: 'Front-matter keys this repository uses beyond the built-in ones.' },\n    archiving: {\n      type: 'object',\n      properties: {\n        tasks: {\n          type: 'anyOf',\n          description: '\"all\", or the sections whose task items must be closed before archiving.',\n          options: [{ type: 'string', enum: ['all'] }, STRINGS],\n        },\n        dispositions: { ...STRINGS, description: 'Text under an open box that closes it without a tick.' },\n        banner: {\n          type: 'array',\n          items: { type: 'string' },\n          description: 'Lines of the frozen banner; a line with an empty {placeholder} is left out, and an empty line separates paragraphs.',\n        },\n        rewriteLinks: { type: 'boolean', description: 'Rewrite relative links so they resolve from the new directory.' },\n        freeze: { type: 'boolean', description: 'Record a content hash so later edits are caught.' },\n        base: { type: 'string', nullable: true, description: 'Branch the diff is measured from, such as \"main\".' },\n      },\n    },\n    rules: { type: 'map', values: SEVERITY, description: 'Severity per rule id.' },\n    plugins: {\n      type: 'array',\n      description: 'Modules that contribute rules.',\n      items: {\n        type: 'anyOf',\n        options: [\n          { type: 'string', minLength: 1 },\n          {\n            type: 'object',\n            required: ['module'],\n            properties: { module: { type: 'string', minLength: 1 }, options: { type: 'any' } },\n          },\n        ],\n      },\n    },\n  },\n};\n\nfunction section(name: string, extra: Partial<Omit<SectionRule, 'name'>> = {}): SectionRule {\n  return { name, aliases: [], mustContain: [], checklist: false, optional: false, ...extra };\n}\n\nexport const DEFAULT_CONFIG: Config = {\n  briefs: 'briefs',\n  archive: 'briefs/archive',\n  files: '[0-9]*.md',\n  exclude: [],\n  template: null,\n  id: { source: 'filename', separator: '_', digits: 3 },\n  status: { field: 'status', draft: 'draft', active: 'active', deferred: 'deferred', archived: 'archived' },\n  sections: [\n    section('Intent', {\n      aliases: [\"Commander's Intent\", 'Mission', 'Objective'],\n      hint: 'The state of the tree when this round is done, and why it matters. One paragraph.',\n    }),\n    section('Negative Scope', {\n      aliases: ['Out of Scope', 'Non-Goals', 'Not in Scope', 'What this round is NOT', 'What this brief does NOT do'],\n      hint: 'What this round must not do, even where it would look helpful.',\n    }),\n    section('Not Empowered', {\n      aliases: ['Non-Empowerment', 'Non-Empowerment List'],\n      optional: true,\n      hint: 'Files, interfaces and decisions this round may not change.',\n    }),\n    section('Invariants', {\n      aliases: ['Invariant Checklist', 'Definition of Done'],\n      checklist: true,\n      hint: 'Checks that must hold before the round is called done, each one a task item.',\n    }),\n  ],\n  sectionOrder: false,\n  types: {\n    feature: [section('Acceptance Criteria', { checklist: true, hint: 'What a reviewer checks to accept the result, each one a task item.' })],\n    defect: [\n      section('The Defect, Measured', {\n        aliases: ['Reproduction'],\n        hint: 'How to reproduce the defect, and the measurement that shows it.',\n      }),\n    ],\n    refactor: [],\n    chore: [],\n  },\n  placeholders: ['TBD', 'TBA', 'TODO', 'FIXME', 'XXX', '???', '...', '\\u2026'],\n  fields: [],\n  archiving: {\n    tasks: 'all',\n    dispositions: ['**Delegated', '**Accepted debt', '**Rejected'],\n    banner: [\n      '**Archived {date}.**',\n      '{summary}',\n      'Merged in pull request {pr}.',\n      'Recorded at commit `{commit}`: {diffstat}.',\n      '{links}',\n      'The body below describes the tree before execution and is not maintained.',\n    ],\n    rewriteLinks: true,\n    freeze: true,\n    base: null,\n  },\n  rules: {},\n  plugins: [],\n};\n\ntype Raw = Record<string, unknown>;\n\nfunction sectionFrom(raw: unknown): SectionRule {\n  if (typeof raw === 'string') return section(raw);\n  const r = raw as Raw;\n  return section(r['name'] as string, {\n    aliases: (r['aliases'] as string[] | undefined) ?? [],\n    mustContain: (r['mustContain'] as string[] | undefined) ?? [],\n    checklist: (r['checklist'] as boolean | undefined) ?? false,\n    optional: (r['optional'] as boolean | undefined) ?? false,\n    hint: r['hint'] as string | undefined,\n  });\n}\n\nfunction pluginFrom(raw: unknown): PluginReference {\n  if (typeof raw === 'string') return { module: raw, options: undefined };\n  const r = raw as Raw;\n  return { module: r['module'] as string, options: r['options'] };\n}\n\nexport class ConfigError extends Error {\n  readonly problems: readonly string[];\n\n  constructor(file: string, problems: readonly string[]) {\n    super(`${file}: ${problems.join('; ')}`);\n    this.name = 'ConfigError';\n    this.problems = problems;\n  }\n}\n\n/**\n * Builds a configuration from parsed JSON. Objects merge one level deep over\n * the defaults; lists and `types` replace them, because a repository that\n * names its own sections means those sections and not the defaults as well.\n */\nexport function resolveConfig(raw: unknown, file = 'configuration'): Config {\n  const problems = validate(CONFIG_SCHEMA, raw);\n  if (problems.length > 0) throw new ConfigError(file, problems);\n  const r = raw as Raw;\n  const d = DEFAULT_CONFIG;\n  const merged = <T extends object>(key: string, base: T): T => ({ ...base, ...((r[key] as Partial<T>) ?? {}) });\n  const archiving = merged('archiving', d.archiving);\n  const config: Config = {\n    briefs: (r['briefs'] as string | undefined) ?? d.briefs,\n    archive: (r['archive'] as string | undefined) ?? (r['briefs'] === undefined ? d.archive : `${r['briefs'] as string}/archive`),\n    files: (r['files'] as string | undefined) ?? d.files,\n    exclude: (r['exclude'] as string[] | undefined) ?? d.exclude,\n    template: r['template'] === undefined ? d.template : (r['template'] as string | null),\n    id: merged('id', d.id),\n    status: merged('status', d.status),\n    sections: r['sections'] === undefined ? d.sections : (r['sections'] as unknown[]).map(sectionFrom),\n    sectionOrder: (r['sectionOrder'] as boolean | undefined) ?? d.sectionOrder,\n    types:\n      r['types'] === undefined\n        ? d.types\n        : Object.fromEntries(\n            Object.entries(r['types'] as Record<string, Raw>).map(([name, type]) => [\n              name,\n              ((type['sections'] as unknown[] | undefined) ?? []).map(sectionFrom),\n            ]),\n          ),\n    placeholders: (r['placeholders'] as string[] | undefined) ?? d.placeholders,\n    fields: (r['fields'] as string[] | undefined) ?? d.fields,\n    archiving,\n    rules: { ...d.rules, ...((r['rules'] as Record<string, SeveritySetting> | undefined) ?? {}) },\n    plugins: ((r['plugins'] as unknown[] | undefined) ?? []).map(pluginFrom),\n  };\n  const semantic = checkConfig(config);\n  if (semantic.length > 0) throw new ConfigError(file, semantic);\n  return config;\n}\n\n/**\n * The sections a brief type adds, or `undefined` for a type the configuration\n * does not define. Its own keys only: every object answers to `constructor`\n * and `toString`, and a brief may say either.\n */\nexport function typeSections(config: Config, type: string): readonly SectionRule[] | undefined {\n  return Object.hasOwn(config.types, type) ? config.types[type] : undefined;\n}\n\n/** The status words a repository uses, in lifecycle order. */\nexport function statusWords(config: Config): string[] {\n  const { draft, active, deferred, archived } = config.status;\n  return [draft, active, deferred, archived].filter((w) => w !== null);\n}\n\n/** What the schema cannot say: relationships between values. */\nfunction checkConfig(config: Config): string[] {\n  const problems: string[] = [];\n  const inside = (key: string, path: string): string | null => {\n    try {\n      return normalisePath(path);\n    } catch {\n      problems.push(`\"${key}\" must be a directory inside the repository, not \"${path}\"`);\n      return null;\n    }\n  };\n  const briefs = inside('briefs', config.briefs);\n  const archive = inside('archive', config.archive);\n  if (briefs !== null && briefs === archive) problems.push('\"briefs\" and \"archive\" must be different directories');\n  // Named by the statuses that share a word: a 0.1 configuration that spelt\n  // another status \"deferred\" meets the default for the new one here.\n  const sharing = new Map<string, { word: string; keys: string[] }>();\n  for (const key of ['draft', 'active', 'deferred', 'archived'] as const) {\n    const word = config.status[key];\n    if (word === null) continue;\n    const group = sharing.get(word.toLowerCase()) ?? { word, keys: [] };\n    group.keys.push(key);\n    sharing.set(word.toLowerCase(), group);\n  }\n  for (const { word, keys } of sharing.values()) {\n    if (keys.length < 2) continue;\n    const orNull = keys.includes('deferred') ? ', or set \"status.deferred\" to null where no work is deferred' : '';\n    problems.push(`the status words must differ: \"${word}\" is the word for ${inWords(keys)}; give ${keys.length === 2 ? 'one of them' : 'all but one'} another word${orNull}`);\n  }\n  // A pattern that does not parse would match nothing, and a run over no briefs reads as clean.\n  for (const [key, pattern] of [['files', config.files], ...config.exclude.map((e) => ['exclude', e] as const)] as const) {\n    const parsed = parseGlob(pattern);\n    if (!parsed.ok) problems.push(`\"${key}\" pattern \"${pattern}\": ${parsed.error}`);\n  }\n  // An unknown hole is never filled, and a line with an unfilled hole is left\n  // out: a misspelt placeholder would silently drop its whole line.\n  for (const line of config.archiving.banner) {\n    for (const hole of templateHoles(line)) {\n      if (!BANNER_PLACEHOLDERS.includes(hole)) {\n        problems.push(`\"archiving.banner\" uses {${hole}}; the placeholders are ${BANNER_PLACEHOLDERS.map((p) => `{${p}}`).join(', ')}`);\n      }\n    }\n  }\n  return problems;\n}\n\n/** Parses the text of a configuration file. */\nexport function parseConfig(text: string, file: string): Config {\n  let raw: unknown;\n  try {\n    raw = JSON.parse(text.charCodeAt(0) === 0xfeff ? text.slice(1) : text);\n  } catch (error) {\n    throw new ConfigError(file, [`is not valid JSON (${(error as Error).message})`]);\n  }\n  return resolveConfig(raw, file);\n}\n\n/**\n * The configuration file for a directory: the nearest one at or above it.\n * `exists` is injected so discovery needs no filesystem of its own.\n */\nexport async function locateConfig(\n  start: string,\n  exists: (path: string) => Promise<boolean>,\n): Promise<string | undefined> {\n  let directory = start;\n  // Each pass moves one directory up, and no path is 256 deep: the bound is\n  // never met, however it is counted. It is there so that the loop ends by\n  // construction.\n  for (let depth = 0; depth < 256; depth += 1) {\n    const found: string[] = [];\n    for (const name of CONFIG_FILES) {\n      const candidate = join(directory, name);\n      if (await exists(candidate)) found.push(candidate);\n    }\n    if (found.length > 1) {\n      throw new ConfigError(directory, [`holds both ${CONFIG_FILES.join(' and ')}; keep one`]);\n    }\n    if (found[0] !== undefined) return found[0];\n    const parent = dirname(directory);\n    // The root is its own parent. Left to the bound, every pass after this one would ask the root again and hear the same.\n    if (parent === directory) return undefined;\n    directory = parent;\n  }\n  /* v8 ignore next -- no path is 256 directories deep; the bound exists so the loop ends by construction. */\n  return undefined;\n}\n\n/** The JSON Schema published as `schema.json`. */\nexport function configJsonSchema(): Record<string, unknown> {\n  return {\n    $schema: 'https://json-schema.org/draft/2020-12/schema',\n    $id: SCHEMA_URL,\n    title: 'spec-brief configuration',\n    ...toJsonSchema(CONFIG_SCHEMA),\n  };\n}\n\n/** The configuration `init` writes: every default spelled out, so it can be edited rather than looked up. */\nexport function initialConfig(briefs: string, archive: string): Record<string, unknown> {\n  const d = DEFAULT_CONFIG;\n  // What the default sections say, and no more: each has a hint, and none\n  // requires text. A default that comes to say more fails the test that this\n  // file means the defaults.\n  const sectionJson = (s: SectionRule): unknown => {\n    const out: Record<string, unknown> = { name: s.name };\n    if (s.aliases.length > 0) out['aliases'] = s.aliases;\n    if (s.checklist) out['checklist'] = true;\n    if (s.optional) out['optional'] = true;\n    out['hint'] = s.hint;\n    return out;\n  };\n  return {\n    $schema: SCHEMA_PATH,\n    briefs,\n    archive,\n    files: d.files,\n    id: d.id,\n    status: d.status,\n    sections: d.sections.map(sectionJson),\n    types: Object.fromEntries(Object.entries(d.types).map(([k, v]) => [k, { sections: v.map(sectionJson) }])),\n    archiving: {\n      tasks: d.archiving.tasks,\n      dispositions: d.archiving.dispositions,\n      banner: d.archiving.banner,\n      base: d.archiving.base,\n    },\n  };\n}\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Configuration: what it may say, what it says when it says nothing, and how a\n * file becomes a `Config`.\n *\n * Every repository that already keeps briefs keeps them its own way - where\n * they live, what the sections are called, which word means \"done\" - so the\n * conventions are data here rather than code. The defaults describe a brief\n * with the four parts every round needs: an intent, a negative scope, what the\n * round is not empowered to touch, and the invariants that prove it is done.\n *\n * A configuration that does not load stops the run. A typo that silently\n * falls back to defaults produces a clean-looking report about the wrong\n * rules, which is worse than no report.\n */\n\nimport { dirname, join } from 'node:path';\n\nimport { parseGlob } from './glob.js';\nimport { normalisePath } from './links.js';\nimport { type Schema, toJsonSchema, validate } from './schema.js';\nimport { inWords, templateHoles } from './text.js';\nimport type { SeveritySetting } from './types.js';\n\nexport interface SectionRule {\n  readonly name: string;\n  readonly aliases: readonly string[];\n  /** Literal text the section must contain, compared exactly. */\n  readonly mustContain: readonly string[];\n  /** The section must hold at least one task item. */\n  readonly checklist: boolean;\n  readonly optional: boolean;\n  /**\n   * What the section must answer. A new brief carries it as a comment under\n   * the heading, a finding that the section is missing or unwritten carries it\n   * as its hint, and `list` and `lint` report it, so a tool that helps write a\n   * brief can ask for each section without knowing its name in advance.\n   */\n  readonly hint?: string | undefined;\n}\n\nexport interface PluginReference {\n  readonly module: string;\n  readonly options: unknown;\n}\n\nexport interface Config {\n  /** Directory of live briefs, relative to the root. */\n  readonly briefs: string;\n  /** Directory of archived briefs, relative to the root. */\n  readonly archive: string;\n  /** Glob a file name must match to be a brief. */\n  readonly files: string;\n  /** File-name globs that are never briefs, such as an index. */\n  readonly exclude: readonly string[];\n  /** A template for `new`, relative to the root; `null` builds one from `sections`. */\n  readonly template: string | null;\n  readonly id: {\n    readonly source: 'filename' | 'frontmatter';\n    readonly separator: string;\n    readonly digits: number;\n  };\n  readonly status: {\n    readonly field: string | null;\n    readonly draft: string | null;\n    readonly active: string;\n    /** The word for work put off until an event its `trigger` names; `null` when a repository has none. */\n    readonly deferred: string | null;\n    readonly archived: string;\n  };\n  readonly sections: readonly SectionRule[];\n  readonly sectionOrder: boolean;\n  readonly types: Readonly<Record<string, readonly SectionRule[]>>;\n  readonly placeholders: readonly string[];\n  readonly fields: readonly string[];\n  readonly archiving: {\n    readonly tasks: 'all' | readonly string[];\n    readonly dispositions: readonly string[];\n    readonly banner: readonly string[];\n    readonly rewriteLinks: boolean;\n    readonly freeze: boolean;\n    readonly base: string | null;\n  };\n  readonly rules: Readonly<Record<string, SeveritySetting>>;\n  readonly plugins: readonly PluginReference[];\n}\n\nexport const CONFIG_FILES: readonly string[] = ['.spec-brief.json', 'spec-brief.json'];\n\n/** The holes a banner line may use. */\nexport const BANNER_PLACEHOLDERS: readonly string[] = [\n  'date',\n  'summary',\n  'pr',\n  'commit',\n  'diffstat',\n  'links',\n  'id',\n  'title',\n  'author',\n];\n\nexport const SCHEMA_URL = 'https://raw.githubusercontent.com/DescentVTT/spec-brief/main/schema.json';\n\n/**\n * The `$schema` `init` writes, the path the README recommends: the schema of\n * the version installed, which is the one that loads the file. `SCHEMA_URL`\n * follows main, and would flag a key the installed version accepts, or pass\n * one it refuses, as soon as the two differ.\n */\nexport const SCHEMA_PATH = './node_modules/@descent-vtt/spec-brief/schema.json';\n\nconst SEVERITY: Schema = { type: 'string', enum: ['off', 'note', 'warning', 'error'] };\nconst STRINGS: Schema = { type: 'array', items: { type: 'string', minLength: 1 } };\n\nconst SECTION: Schema = {\n  type: 'anyOf',\n  description: 'A section name, or a section with aliases and content rules.',\n  options: [\n    { type: 'string', minLength: 1 },\n    {\n      type: 'object',\n      required: ['name'],\n      properties: {\n        name: { type: 'string', minLength: 1, description: 'The heading text, compared without case or punctuation.' },\n        aliases: { ...STRINGS, description: 'Other headings that fill this section.' },\n        mustContain: { ...STRINGS, description: 'Literal text the section must contain.' },\n        checklist: { type: 'boolean', description: 'The section must hold at least one \"- [ ]\" task item.' },\n        optional: { type: 'boolean', description: 'Checked when present, not required.' },\n        hint: {\n          type: 'string',\n          minLength: 1,\n          description: 'What the section must answer: a comment under the heading in a new brief, and the hint of a finding that it is missing or unwritten.',\n        },\n      },\n    },\n  ],\n};\n\nexport const CONFIG_SCHEMA: Schema = {\n  type: 'object',\n  properties: {\n    $schema: { type: 'string' },\n    briefs: { type: 'string', minLength: 1, description: 'Directory of live briefs, relative to this file.' },\n    archive: { type: 'string', minLength: 1, description: 'Directory of archived briefs, relative to this file.' },\n    files: { type: 'string', minLength: 1, description: 'Glob a file name must match to be a brief.' },\n    exclude: { ...STRINGS, description: 'File-name globs that are never briefs.' },\n    template: { type: 'string', nullable: true, description: 'Template file for \"new\"; null builds one from the sections.' },\n    id: {\n      type: 'object',\n      properties: {\n        source: { type: 'string', enum: ['filename', 'frontmatter'], description: 'Where a brief id comes from.' },\n        separator: { type: 'string', minLength: 1, description: 'Separates the id from the slug in a file name.' },\n        digits: { type: 'integer', minimum: 1, maximum: 12, description: 'Width of an allocated numeric id.' },\n      },\n    },\n    status: {\n      type: 'object',\n      properties: {\n        field: { type: 'string', nullable: true, description: 'Front-matter key holding the status; null uses location only.' },\n        draft: { type: 'string', nullable: true, description: 'The word for a brief still being written, or null.' },\n        active: { type: 'string', minLength: 1, description: 'The word for a live brief.' },\n        deferred: {\n          type: 'string',\n          nullable: true,\n          description: 'The word for a live brief put off until the event its \"trigger\" names, or null. A deferred brief is never ready and runs in no wave.',\n        },\n        archived: { type: 'string', minLength: 1, description: 'The word for an archived brief.' },\n      },\n    },\n    sections: { type: 'array', items: SECTION, description: 'Sections every live brief carries.' },\n    sectionOrder: { type: 'boolean', description: 'Sections must appear in the order listed.' },\n    types: {\n      type: 'map',\n      description: 'Brief types, each with the sections it adds.',\n      values: { type: 'object', properties: { sections: { type: 'array', items: SECTION } } },\n    },\n    placeholders: { ...STRINGS, description: 'Words that mark a section as unwritten.' },\n    fields: { ...STRINGS, description: 'Front-matter keys this repository uses beyond the built-in ones.' },\n    archiving: {\n      type: 'object',\n      properties: {\n        tasks: {\n          type: 'anyOf',\n          description: '\"all\", or the sections whose task items must be closed before archiving.',\n          options: [{ type: 'string', enum: ['all'] }, STRINGS],\n        },\n        dispositions: { ...STRINGS, description: 'Text under an open box that closes it without a tick.' },\n        banner: {\n          type: 'array',\n          items: { type: 'string' },\n          description: 'Lines of the frozen banner; a line with an empty {placeholder} is left out, and an empty line separates paragraphs.',\n        },\n        rewriteLinks: { type: 'boolean', description: 'Rewrite relative links so they resolve from the new directory.' },\n        freeze: { type: 'boolean', description: 'Record a content hash so later edits are caught.' },\n        base: { type: 'string', nullable: true, description: 'Branch the diff is measured from, such as \"main\".' },\n      },\n    },\n    rules: { type: 'map', values: SEVERITY, description: 'Severity per rule id.' },\n    plugins: {\n      type: 'array',\n      description: 'Modules that contribute rules.',\n      items: {\n        type: 'anyOf',\n        options: [\n          { type: 'string', minLength: 1 },\n          {\n            type: 'object',\n            required: ['module'],\n            properties: { module: { type: 'string', minLength: 1 }, options: { type: 'any' } },\n          },\n        ],\n      },\n    },\n  },\n};\n\nfunction section(name: string, extra: Partial<Omit<SectionRule, 'name'>> = {}): SectionRule {\n  return { name, aliases: [], mustContain: [], checklist: false, optional: false, ...extra };\n}\n\nexport const DEFAULT_CONFIG: Config = {\n  briefs: 'briefs',\n  archive: 'briefs/archive',\n  files: '[0-9]*.md',\n  exclude: [],\n  template: null,\n  id: { source: 'filename', separator: '_', digits: 3 },\n  status: { field: 'status', draft: 'draft', active: 'active', deferred: 'deferred', archived: 'archived' },\n  sections: [\n    section('Intent', {\n      aliases: [\"Commander's Intent\", 'Mission', 'Objective'],\n      hint: 'The state of the tree when this round is done, and why it matters. One paragraph.',\n    }),\n    section('Negative Scope', {\n      aliases: ['Out of Scope', 'Non-Goals', 'Not in Scope', 'What this round is NOT', 'What this brief does NOT do'],\n      hint: 'What this round must not do, even where it would look helpful.',\n    }),\n    section('Not Empowered', {\n      aliases: ['Non-Empowerment', 'Non-Empowerment List'],\n      optional: true,\n      hint: 'Files, interfaces and decisions this round may not change.',\n    }),\n    section('Invariants', {\n      aliases: ['Invariant Checklist', 'Definition of Done'],\n      checklist: true,\n      hint: 'Checks that must hold before the round is called done, each one a task item.',\n    }),\n  ],\n  sectionOrder: false,\n  types: {\n    feature: [section('Acceptance Criteria', { checklist: true, hint: 'What a reviewer checks to accept the result, each one a task item.' })],\n    defect: [\n      section('The Defect, Measured', {\n        aliases: ['Reproduction'],\n        hint: 'How to reproduce the defect, and the measurement that shows it.',\n      }),\n    ],\n    refactor: [],\n    chore: [],\n  },\n  placeholders: ['TBD', 'TBA', 'TODO', 'FIXME', 'XXX', '???', '...', '\\u2026'],\n  fields: [],\n  archiving: {\n    tasks: 'all',\n    dispositions: ['**Delegated', '**Accepted debt', '**Rejected'],\n    banner: [\n      '**Archived {date}.**',\n      '{summary}',\n      'Merged in pull request {pr}.',\n      'Recorded at commit `{commit}`: {diffstat}.',\n      '{links}',\n      'The body below describes the tree before execution and is not maintained.',\n    ],\n    rewriteLinks: true,\n    freeze: true,\n    base: null,\n  },\n  rules: {},\n  plugins: [],\n};\n\ntype Raw = Record<string, unknown>;\n\nfunction sectionFrom(raw: unknown): SectionRule {\n  if (typeof raw === 'string') return section(raw);\n  const r = raw as Raw;\n  return section(r['name'] as string, {\n    aliases: (r['aliases'] as string[] | undefined) ?? [],\n    mustContain: (r['mustContain'] as string[] | undefined) ?? [],\n    checklist: (r['checklist'] as boolean | undefined) ?? false,\n    optional: (r['optional'] as boolean | undefined) ?? false,\n    hint: r['hint'] as string | undefined,\n  });\n}\n\nfunction pluginFrom(raw: unknown): PluginReference {\n  if (typeof raw === 'string') return { module: raw, options: undefined };\n  const r = raw as Raw;\n  return { module: r['module'] as string, options: r['options'] };\n}\n\nexport class ConfigError extends Error {\n  readonly problems: readonly string[];\n\n  constructor(file: string, problems: readonly string[]) {\n    super(`${file}: ${problems.join('; ')}`);\n    this.name = 'ConfigError';\n    this.problems = problems;\n  }\n}\n\n/**\n * Builds a configuration from parsed JSON. Objects merge one level deep over\n * the defaults; lists and `types` replace them, because a repository that\n * names its own sections means those sections and not the defaults as well.\n */\nexport function resolveConfig(raw: unknown, file = 'configuration'): Config {\n  const problems = validate(CONFIG_SCHEMA, raw);\n  if (problems.length > 0) throw new ConfigError(file, problems);\n  const r = raw as Raw;\n  const d = DEFAULT_CONFIG;\n  const merged = <T extends object>(key: string, base: T): T => ({ ...base, ...((r[key] as Partial<T>) ?? {}) });\n  const archiving = merged('archiving', d.archiving);\n  const config: Config = {\n    briefs: (r['briefs'] as string | undefined) ?? d.briefs,\n    archive: (r['archive'] as string | undefined) ?? (r['briefs'] === undefined ? d.archive : `${r['briefs'] as string}/archive`),\n    files: (r['files'] as string | undefined) ?? d.files,\n    exclude: (r['exclude'] as string[] | undefined) ?? d.exclude,\n    template: r['template'] === undefined ? d.template : (r['template'] as string | null),\n    id: merged('id', d.id),\n    status: merged('status', d.status),\n    sections: r['sections'] === undefined ? d.sections : (r['sections'] as unknown[]).map(sectionFrom),\n    sectionOrder: (r['sectionOrder'] as boolean | undefined) ?? d.sectionOrder,\n    types:\n      r['types'] === undefined\n        ? d.types\n        : Object.fromEntries(\n            Object.entries(r['types'] as Record<string, Raw>).map(([name, type]) => [\n              name,\n              ((type['sections'] as unknown[] | undefined) ?? []).map(sectionFrom),\n            ]),\n          ),\n    placeholders: (r['placeholders'] as string[] | undefined) ?? d.placeholders,\n    fields: (r['fields'] as string[] | undefined) ?? d.fields,\n    archiving,\n    rules: { ...d.rules, ...((r['rules'] as Record<string, SeveritySetting> | undefined) ?? {}) },\n    plugins: ((r['plugins'] as unknown[] | undefined) ?? []).map(pluginFrom),\n  };\n  const semantic = checkConfig(config);\n  if (semantic.length > 0) throw new ConfigError(file, semantic);\n  return config;\n}\n\n/**\n * The sections a brief type adds, or `undefined` for a type the configuration\n * does not define. Its own keys only: every object answers to `constructor`\n * and `toString`, and a brief may say either.\n */\nexport function typeSections(config: Config, type: string): readonly SectionRule[] | undefined {\n  return Object.hasOwn(config.types, type) ? config.types[type] : undefined;\n}\n\n/** The status words a repository uses, in lifecycle order. */\nexport function statusWords(config: Config): string[] {\n  const { draft, active, deferred, archived } = config.status;\n  return [draft, active, deferred, archived].filter((w) => w !== null);\n}\n\n/** What the schema cannot say: relationships between values. */\nfunction checkConfig(config: Config): string[] {\n  const problems: string[] = [];\n  const inside = (key: string, path: string): string | null => {\n    try {\n      return normalisePath(path);\n    } catch {\n      problems.push(`\"${key}\" must be a directory inside the repository, not \"${path}\"`);\n      return null;\n    }\n  };\n  const briefs = inside('briefs', config.briefs);\n  const archive = inside('archive', config.archive);\n  if (briefs !== null && briefs === archive) problems.push('\"briefs\" and \"archive\" must be different directories');\n  // Named by the statuses that share a word: a 0.1 configuration that spelt\n  // another status \"deferred\" meets the default for the new one here.\n  const sharing = new Map<string, { word: string; keys: string[] }>();\n  for (const key of ['draft', 'active', 'deferred', 'archived'] as const) {\n    const word = config.status[key];\n    if (word === null) continue;\n    const group = sharing.get(word.toLowerCase()) ?? { word, keys: [] };\n    group.keys.push(key);\n    sharing.set(word.toLowerCase(), group);\n  }\n  for (const { word, keys } of sharing.values()) {\n    if (keys.length < 2) continue;\n    const orNull = keys.includes('deferred') ? ', or set \"status.deferred\" to null where no work is deferred' : '';\n    problems.push(`the status words must differ: \"${word}\" is the word for ${inWords(keys)}; give ${keys.length === 2 ? 'one of them' : 'all but one'} another word${orNull}`);\n  }\n  // A pattern that does not parse would match nothing, and a run over no briefs reads as clean.\n  for (const [key, pattern] of [['files', config.files], ...config.exclude.map((e) => ['exclude', e] as const)] as const) {\n    const parsed = parseGlob(pattern);\n    if (!parsed.ok) problems.push(`\"${key}\" pattern \"${pattern}\": ${parsed.error}`);\n  }\n  // An unknown hole is never filled, and a line with an unfilled hole is left\n  // out: a misspelt placeholder would silently drop its whole line.\n  for (const line of config.archiving.banner) {\n    for (const hole of templateHoles(line)) {\n      if (!BANNER_PLACEHOLDERS.includes(hole)) {\n        problems.push(`\"archiving.banner\" uses {${hole}}; the placeholders are ${BANNER_PLACEHOLDERS.map((p) => `{${p}}`).join(', ')}`);\n      }\n    }\n  }\n  return problems;\n}\n\n/** Parses the text of a configuration file. */\nexport function parseConfig(text: string, file: string): Config {\n  let raw: unknown;\n  try {\n    raw = JSON.parse(text.charCodeAt(0) === 0xfeff ? text.slice(1) : text);\n  } catch (error) {\n    // The parser quotes what it could not read. A line break quoted from the\n    // file made this refusal two lines, and any other control character was\n    // handed to the terminal: each is written as its escape.\n    const said = (error as Error).message.replace(/[\\u0000-\\u001f\\u007f-\\u009f]/g, (c) => `\\\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);\n    throw new ConfigError(file, [`is not valid JSON (${said})`]);\n  }\n  return resolveConfig(raw, file);\n}\n\n/**\n * The configuration file for a directory: the nearest one at or above it.\n * `exists` is injected so discovery needs no filesystem of its own.\n */\nexport async function locateConfig(\n  start: string,\n  exists: (path: string) => Promise<boolean>,\n): Promise<string | undefined> {\n  let directory = start;\n  // Each pass moves one directory up, and no path is 256 deep: the bound is\n  // never met, however it is counted. It is there so that the loop ends by\n  // construction.\n  for (let depth = 0; depth < 256; depth += 1) {\n    const found: string[] = [];\n    for (const name of CONFIG_FILES) {\n      const candidate = join(directory, name);\n      if (await exists(candidate)) found.push(candidate);\n    }\n    if (found.length > 1) {\n      throw new ConfigError(directory, [`holds both ${CONFIG_FILES.join(' and ')}; keep one`]);\n    }\n    if (found[0] !== undefined) return found[0];\n    const parent = dirname(directory);\n    // The root is its own parent. Left to the bound, every pass after this one would ask the root again and hear the same.\n    if (parent === directory) return undefined;\n    directory = parent;\n  }\n  /* v8 ignore next -- no path is 256 directories deep; the bound exists so the loop ends by construction. */\n  return undefined;\n}\n\n/** The JSON Schema published as `schema.json`. */\nexport function configJsonSchema(): Record<string, unknown> {\n  return {\n    $schema: 'https://json-schema.org/draft/2020-12/schema',\n    $id: SCHEMA_URL,\n    title: 'spec-brief configuration',\n    ...toJsonSchema(CONFIG_SCHEMA),\n  };\n}\n\n/** The configuration `init` writes: every default spelled out, so it can be edited rather than looked up. */\nexport function initialConfig(briefs: string, archive: string): Record<string, unknown> {\n  const d = DEFAULT_CONFIG;\n  // What the default sections say, and no more: each has a hint, and none\n  // requires text. A default that comes to say more fails the test that this\n  // file means the defaults.\n  const sectionJson = (s: SectionRule): unknown => {\n    const out: Record<string, unknown> = { name: s.name };\n    if (s.aliases.length > 0) out['aliases'] = s.aliases;\n    if (s.checklist) out['checklist'] = true;\n    if (s.optional) out['optional'] = true;\n    out['hint'] = s.hint;\n    return out;\n  };\n  return {\n    $schema: SCHEMA_PATH,\n    briefs,\n    archive,\n    files: d.files,\n    id: d.id,\n    status: d.status,\n    sections: d.sections.map(sectionJson),\n    types: Object.fromEntries(Object.entries(d.types).map(([k, v]) => [k, { sections: v.map(sectionJson) }])),\n    archiving: {\n      tasks: d.archiving.tasks,\n      dispositions: d.archiving.dispositions,\n      banner: d.archiving.banner,\n      base: d.archiving.base,\n    },\n  };\n}\n"]}

package/dist/engine.d.ts

@@ -68,9 +68,12 @@ export interface NewOptions {
  * Today, in UTC. `SOURCE_DATE_EPOCH` wins where it is set, which is what makes
  * a banner written in a reproducible pipeline reproducible.
  *
- * A number of seconds past the last date there is, 8640000000000, makes no
- * date, and the date's own complaint is a RangeError that names no variable:
- * it is refused here, by name. What is not a whole number is read as unset.
+ * Set, it is what its specification says it is: whole seconds since
+ * 1970-01-01 in digits alone, as `date +%s` prints them, and here no later
+ * than the last date written YYYY-MM-DD. Anything else is refused by name,
+ * an empty value too, which is what a command substitution that failed
+ * leaves. Read as unset, it had the run write the clock's date where a
+ * pipeline asked for its own, and say nothing.
  */
 export declare function today(env?: Readonly<Record<string, string | undefined>>): string;
 export declare function isDate(text: string): boolean;

package/dist/engine.js

@@ -42,20 +42,32 @@ async function exists(path) {
         return false;
     }
 }
+/** The last second of 9999-12-31, the last date written YYYY-MM-DD. */
+const LAST_SECOND = 253402300799;
 /**
  * Today, in UTC. `SOURCE_DATE_EPOCH` wins where it is set, which is what makes
  * a banner written in a reproducible pipeline reproducible.
  *
- * A number of seconds past the last date there is, 8640000000000, makes no
- * date, and the date's own complaint is a RangeError that names no variable:
- * it is refused here, by name. What is not a whole number is read as unset.
+ * Set, it is what its specification says it is: whole seconds since
+ * 1970-01-01 in digits alone, as `date +%s` prints them, and here no later
+ * than the last date written YYYY-MM-DD. Anything else is refused by name,
+ * an empty value too, which is what a command substitution that failed
+ * leaves. Read as unset, it had the run write the clock's date where a
+ * pipeline asked for its own, and say nothing.
  */
 export function today(env = process.env) {
     const epoch = env['SOURCE_DATE_EPOCH'];
-    // The check for a variable that is not set is the compiler's: unset, it would read as "undefined", which is no number.
-    const when = epoch !== undefined && /^\d+$/.test(epoch) ? new Date(Number(epoch) * 1000) : new Date();
-    if (Number.isNaN(when.getTime())) {
-        throw new EngineError('invalid', `SOURCE_DATE_EPOCH is "${epoch}", which is not a time: no date is that many seconds after 1970-01-01; set it to a date's seconds, or unset it`);
+    let when = new Date();
+    if (epoch !== undefined) {
+        // Quoted as JSON, so a newline or a tab in it is seen, and the refusal stays one line.
+        const held = `SOURCE_DATE_EPOCH is ${JSON.stringify(epoch)}`;
+        if (!/^\d+$/.test(epoch)) {
+            throw new EngineError('invalid', `${held}, which is not a whole number of seconds since 1970-01-01; set it to one in digits alone, as "date +%s" prints it, or unset it`);
+        }
+        if (Number(epoch) > LAST_SECOND) {
+            throw new EngineError('invalid', `${held}, which is after 9999-12-31, the last date written YYYY-MM-DD; set it to ${LAST_SECOND} or less, or unset it`);
+        }
+        when = new Date(Number(epoch) * 1000);
     }
     return when.toISOString().slice(0, 10);
 }
@@ -118,7 +130,13 @@ export class BriefEngine {
         const root = configPath === undefined ? (toplevel ?? cwd) : dirname(configPath);
         let config = DEFAULT_CONFIG;
         if (configPath !== undefined) {
-            const text = await new NodeFileSystem(root).read(basename(configPath));
+            const text = await new NodeFileSystem(root).read(basename(configPath)).catch((error) => {
+                // A directory of that name, found or named with --config, is a
+                // configuration that does not load, and no defect to report a stack for.
+                if (error.code !== 'EISDIR')
+                    throw error;
+                throw new ConfigError(relative(cwd, configPath), ['is a directory, not a configuration file']);
+            });
             if (text === null)
                 throw new EngineError('not-found', `${configPath} does not exist`);
             config = parseConfig(text, relative(cwd, configPath));

package/dist/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The engine: one repository's briefs, with the operations the CLI offers and\n * the same ones for a harness or an orchestrator that would rather call a\n * function than parse a terminal.\n *\n * This module and the CLI are where the pieces meet their implementations -\n * the real filesystem, the real git, the plugins a configuration names.\n * Everything they compose is a pure function that takes those as arguments,\n * so an engine can equally run over a `MemoryFileSystem` and no git at all.\n */\n\nimport { access } from 'node:fs/promises';\nimport { basename, dirname, relative, resolve, sep } from 'node:path';\n\nimport { applyPlan } from './apply.js';\nimport {\n  applyWaivers,\n  planArchive,\n  type Plan,\n  planUnarchive,\n  type PullRequest,\n  type UnarchiveRequest,\n  type Unmeasured,\n  WAIVABLE,\n  type Waiver,\n} from './archive.js';\nimport type { Brief } from './brief.js';\nimport { collisionFindings, collisions, type CollisionOptions, type CollisionReport } from './collisions.js';\nimport { type Config, ConfigError, DEFAULT_CONFIG, locateConfig, parseConfig, typeSections } from './config.js';\nimport { buildCorpus, type Corpus, findBriefs, isReady, pendingDependencies, type SourceFile } from './corpus.js';\nimport { canonicalPath, type FileSystem, NodeFileSystem } from './fs.js';\nimport { type CommitInfo, type FileChange, type Git, NodeGit, pullRequestUrl } from './git.js';\nimport { matchGlob, parseGlob } from './glob.js';\nimport { normalisePath } from './links.js';\nimport { lint, type Plugin } from './lint.js';\nimport { asWaivers, loadPlugins } from './plugins.js';\nimport { fileNameFor, nextId, renderNewBrief } from './scaffold.js';\nimport { planWaves, type Schedule, schedule, scheduleFindings, type ScheduleOptions } from './schedule.js';\nimport type { Finding, Phase } from './types.js';\n\nexport class EngineError extends Error {\n  readonly code: 'not-found' | 'ambiguous' | 'invalid' | 'refused' | 'exists';\n\n  constructor(code: EngineError['code'], message: string) {\n    super(message);\n    this.name = 'EngineError';\n    this.code = code;\n  }\n}\n\nexport interface EngineSetup {\n  /** Absolute root: the directory holding the configuration. */\n  readonly root: string;\n  readonly config: Config;\n  /** Repository-relative configuration path, or `null` when the defaults apply. */\n  readonly configFile: string | null;\n  readonly fs: FileSystem;\n  readonly git: Git | null;\n  readonly plugins?: readonly Plugin[];\n}\n\nexport interface OpenOptions {\n  /** Where discovery starts. Defaults to the process's directory. */\n  readonly cwd?: string;\n  /** An explicit configuration file; discovery is skipped. */\n  readonly config?: string | undefined;\n  /** Use the defaults even where a configuration file exists. */\n  readonly noConfig?: boolean;\n  /** `null` runs without git. Defaults to git when the root is inside a working tree. */\n  readonly git?: Git | null;\n  readonly fs?: FileSystem;\n}\n\nexport interface ArchiveOptions {\n  readonly pr?: number | undefined;\n  /** The commit the round landed as. */\n  readonly commit?: string | undefined;\n  /** The branch the round started from; the diff runs from its merge base. */\n  readonly base?: string | undefined;\n  readonly summary?: string | undefined;\n  readonly date?: string | undefined;\n  readonly allowDirty?: boolean | undefined;\n  readonly strict?: boolean | undefined;\n  /** Leave git out, even where there is a repository. */\n  readonly noGit?: boolean | undefined;\n}\n\nexport interface NewOptions {\n  readonly title: string;\n  readonly id?: string | undefined;\n  readonly type?: string | undefined;\n  readonly wave?: number | undefined;\n  readonly dependsOn?: readonly string[] | undefined;\n  readonly date?: string | undefined;\n}\n\nasync function exists(path: string): Promise<boolean> {\n  try {\n    await access(path);\n    return true;\n  } catch {\n    // Absent, or not to be reached: the search goes on either way. An empty\n    // catch would answer `undefined`, which the search reads the same.\n    return false;\n  }\n}\n\n/**\n * Today, in UTC. `SOURCE_DATE_EPOCH` wins where it is set, which is what makes\n * a banner written in a reproducible pipeline reproducible.\n *\n * A number of seconds past the last date there is, 8640000000000, makes no\n * date, and the date's own complaint is a RangeError that names no variable:\n * it is refused here, by name. What is not a whole number is read as unset.\n */\nexport function today(env: Readonly<Record<string, string | undefined>> = process.env): string {\n  const epoch = env['SOURCE_DATE_EPOCH'];\n  // The check for a variable that is not set is the compiler's: unset, it would read as \"undefined\", which is no number.\n  const when = epoch !== undefined && /^\\d+$/.test(epoch) ? new Date(Number(epoch) * 1000) : new Date();\n  if (Number.isNaN(when.getTime())) {\n    throw new EngineError('invalid', `SOURCE_DATE_EPOCH is \"${epoch}\", which is not a time: no date is that many seconds after 1970-01-01; set it to a date's seconds, or unset it`);\n  }\n  return when.toISOString().slice(0, 10);\n}\n\n/**\n * A deep copy of a value in which every object and array is frozen. Plain\n * data only, as `structuredClone` takes it; the recursion ends at the data's\n * own depth.\n */\nfunction frozenCopy<T>(value: T): T {\n  const freeze = (item: unknown): void => {\n    if (typeof item !== 'object' || item === null) return;\n    for (const child of Object.values(item)) freeze(child);\n    Object.freeze(item);\n  };\n  const copy = structuredClone(value);\n  freeze(copy);\n  return copy;\n}\n\nexport function isDate(text: string): boolean {\n  // The shape keeps out the one other text that survives the round trip\n  // below: a year past 9999 with a month, \"+010000-01\". Its anchors are for\n  // the reader, since nothing longer than a date comes back as it went in.\n  if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(text)) return false;\n  const parsed = new Date(`${text}T00:00:00Z`);\n  return !Number.isNaN(parsed.getTime()) && parsed.toISOString().slice(0, 10) === text;\n}\n\nexport class BriefEngine {\n  readonly root: string;\n  readonly config: Config;\n  readonly configFile: string | null;\n  readonly fs: FileSystem;\n  readonly git: Git | null;\n  private plugins: readonly Plugin[] | undefined;\n  private loaded: Corpus | undefined;\n  /** Known once the briefs are read, which every command does before it asks. */\n  private missingBriefs: boolean | undefined;\n\n  constructor(setup: EngineSetup) {\n    this.root = setup.root;\n    this.config = setup.config;\n    this.configFile = setup.configFile;\n    this.fs = setup.fs;\n    this.git = setup.git;\n    this.plugins = setup.plugins;\n  }\n\n  /**\n   * Finds the configuration, the root it defines and the repository around it,\n   * and reads every brief. The root is the directory holding the\n   * configuration; without one it is the working tree's top, or `cwd`.\n   */\n  static async open(options: OpenOptions = {}): Promise<BriefEngine> {\n    // Named as git names them, so the root and the work tree compare.\n    const cwd = await canonicalPath(resolve(options.cwd ?? process.cwd()));\n    const explicit = options.config === undefined ? undefined : await canonicalPath(resolve(cwd, options.config));\n    const configPath = options.noConfig === true ? undefined : (explicit ?? (await locateConfig(cwd, exists)));\n    // Asking git costs a process; without git there is nothing to ask.\n    const toplevel = options.git === null ? null : await NodeGit.toplevel(cwd);\n    const root = configPath === undefined ? (toplevel ?? cwd) : dirname(configPath);\n    let config = DEFAULT_CONFIG;\n    if (configPath !== undefined) {\n      const text = await new NodeFileSystem(root).read(basename(configPath));\n      if (text === null) throw new EngineError('not-found', `${configPath} does not exist`);\n      config = parseConfig(text, relative(cwd, configPath));\n    }\n    // Outside the work tree is its parent or a path through it, \"..\", \"../x\":\n    // a directory inside it may itself be named \"..drafts\".\n    const fromTop = toplevel === null ? null : relative(toplevel, root);\n    const inTree = fromTop !== null && fromTop !== '..' && !fromTop.startsWith(`..${sep}`);\n    const engine = new BriefEngine({\n      root,\n      config,\n      // The root is the configuration's directory, so its path from there is its name.\n      configFile: configPath === undefined ? null : basename(configPath),\n      fs: options.fs ?? new NodeFileSystem(root),\n      git: options.git === undefined ? (inTree ? new NodeGit(root) : null) : options.git,\n    });\n    await engine.load();\n    return engine;\n  }\n\n  get corpus(): Corpus {\n    if (this.loaded === undefined) throw new Error('the engine has not loaded its briefs; call load() first');\n    return this.loaded;\n  }\n\n  /** Reads every brief again, as after an archival. */\n  async load(): Promise<Corpus> {\n    const files: SourceFile[] = [];\n    const accept = parseGlob(this.config.files);\n    const reject = this.config.exclude.map((pattern) => parseGlob(pattern));\n    const isBrief = (name: string): boolean =>\n      accept.ok && matchGlob(accept.glob, name) && !reject.some((r) => r.ok && matchGlob(r.glob, name));\n    const read = async (directory: string, phase: Phase): Promise<boolean> => {\n      const dir = normalisePath(directory);\n      const names = await this.fs.list(dir);\n      if (names === null) return false;\n      for (const name of names) {\n        if (!isBrief(name)) continue;\n        const path = dir === '' ? name : `${dir}/${name}`;\n        const text = await this.fs.read(path);\n        // A file listed a moment ago and gone now was removed under the run; there is nothing to read.\n        if (text !== null) files.push({ path, text, phase });\n      }\n      return true;\n    };\n    this.missingBriefs = !(await read(this.config.briefs, 'live'));\n    await read(this.config.archive, 'archived');\n    this.loaded = buildCorpus(files, this.config);\n    return this.loaded;\n  }\n\n  /**\n   * Refuses to report on a briefs directory that does not exist. A check over\n   * nothing looks exactly like a clean one, and the likelier cause is a\n   * configuration pointing at the wrong place.\n   */\n  requireBriefs(): void {\n    if (this.missingBriefs) {\n      throw new EngineError('not-found', `${normalisePath(this.config.briefs)}/ does not exist; run \"spec-brief init\", or set \"briefs\" in the configuration`);\n    }\n  }\n\n  /** The plugins the configuration names, loaded once. */\n  async loadedPlugins(): Promise<readonly Plugin[]> {\n    this.plugins ??= await loadPlugins(this.config.plugins, this.root);\n    return this.plugins;\n  }\n\n  /** The one brief a reference names: an id, a file name or a path. */\n  find(reference: string): Brief {\n    const found = findBriefs(this.corpus, reference);\n    if (found.length === 0) throw new EngineError('not-found', `no brief is named \"${reference}\"`);\n    if (found.length > 1) {\n      throw new EngineError('ambiguous', `\"${reference}\" names ${found.length} briefs: ${found.map((b) => b.file).join(', ')}`);\n    }\n    return found[0] as Brief;\n  }\n\n  /** The files git sees, or every file when there is no git; `null` when neither can be read. */\n  async repoFiles(): Promise<string[] | null> {\n    try {\n      return this.git === null ? await this.fs.walk() : await this.git.files();\n    } catch {\n      return null;\n    }\n  }\n\n  async lint(references: readonly string[] = []): Promise<Finding[]> {\n    const only = references.length === 0 ? undefined : references.map((r) => this.find(r));\n    return lint(this.corpus, { plugins: await this.loadedPlugins(), repoFiles: await this.repoFiles(), ...(only ? { only } : {}) });\n  }\n\n  async collisions(options: CollisionOptions = {}): Promise<{ report: CollisionReport; findings: Finding[] }> {\n    const report = collisions(this.corpus, { repoFiles: await this.repoFiles(), ...options });\n    return { report, findings: collisionFindings(this.corpus, report) };\n  }\n\n  async schedule(options: ScheduleOptions = {}): Promise<{ schedule: Schedule; findings: Finding[] }> {\n    const computed = schedule(this.corpus, { repoFiles: await this.repoFiles(), ...options });\n    return { schedule: computed, findings: scheduleFindings(this.corpus, computed) };\n  }\n\n  /**\n   * Writes each brief's proposed wave into its front matter, every other line\n   * as it was, as one transaction. Refused, with nothing written, when the\n   * dependencies form a cycle or a front matter cannot be edited.\n   */\n  async writeWaves(computed: Schedule): Promise<{ written: string[]; refused: Finding[] }> {\n    const plan = planWaves(computed);\n    if (computed.cycles.length > 0 || plan.refused.length > 0) return { written: [], refused: [...plan.refused] };\n    await applyPlan(this.fs, plan.ops);\n    await this.load();\n    return { written: plan.ops.map((op) => op.path), refused: [] };\n  }\n\n  /** Live briefs that can run now: every dependency archived, and neither a draft nor deferred. */\n  ready(): Brief[] {\n    return this.corpus.live.filter((b) => isReady(this.corpus, b));\n  }\n\n  /** The live dependencies holding a brief back. */\n  waitingOn(brief: Brief): string[] {\n    return pendingDependencies(this.corpus, brief);\n  }\n\n  async planArchive(reference: string, options: ArchiveOptions = {}): Promise<Plan> {\n    const brief = this.find(reference);\n    const date = options.date ?? today();\n    if (!isDate(date)) throw new EngineError('invalid', `\"${date}\" is not a date written YYYY-MM-DD`);\n    if (options.noGit === true && (options.commit !== undefined || options.base !== undefined)) {\n      throw new EngineError('invalid', 'a commit or a base needs git; drop --no-git, or drop --commit and --base');\n    }\n    const git = options.noGit === true ? null : this.git;\n    const base = options.base ?? this.config.archiving.base ?? undefined;\n    const findings = await this.lint();\n\n    let commit: CommitInfo | undefined;\n    let changes: FileChange[] | undefined;\n    let unmeasured: Unmeasured | undefined;\n    let dirty: string[] | undefined;\n    let pr: PullRequest | undefined;\n    if (git !== null) {\n      const revision = options.commit ?? (base === undefined ? undefined : 'HEAD');\n      if (revision !== undefined) {\n        commit = (await git.commit(revision)) ?? undefined;\n        if (commit === undefined) throw new EngineError('not-found', `\"${revision}\" names no commit`);\n        let from: string | null = null;\n        if (base !== undefined) {\n          from = await git.mergeBase(base, commit.sha);\n          // No merge base: a base with a history of its own is diffed from\n          // directly, and one that names nothing is a typo to report, not a\n          // diff for git to fail.\n          if (from === null) {\n            if ((await git.commit(base)) === null) {\n              throw new EngineError('not-found', `the base \"${base}\" names no commit; check --base and \"archiving.base\"`);\n            }\n            from = base;\n          }\n        }\n        // A commit that is its own merge base with the base branch is already\n        // in it: the diff is empty whatever the round changed, and an empty\n        // diff would pass every scope check without measuring one.\n        if (from === commit.sha) unmeasured = { reason: 'merged', base: base as string, commit: commit.sha };\n        else changes = await git.changes(from, commit.sha);\n      }\n      // With neither a commit nor a base, nothing was read, and the planner\n      // says so itself of a request that brings no changes and no reason.\n      dirty = await git.dirty();\n    } else {\n      unmeasured = { reason: 'git' };\n    }\n    if (options.pr !== undefined) {\n      pr = { number: options.pr, url: git === null ? null : pullRequestUrl(await git.remoteUrl('origin'), options.pr) };\n    }\n    const plan = planArchive(this.corpus, brief, {\n      date,\n      summary: options.summary,\n      pr,\n      commit,\n      changes,\n      unmeasured,\n      dirty,\n      allowDirty: options.allowDirty,\n      strict: options.strict,\n      findings,\n    });\n    return this.waive(plan, base ?? null, commit?.sha ?? null, options.strict === true);\n  }\n\n  /**\n   * Asks each plugin with a `waive` hook which of a plan's refusals its own\n   * check lifts, and turns those into notes. Asked only when the plan has a\n   * refusal a plugin may lift: a hook may read git and verify signatures, and a\n   * plan with nothing to waive has no question for it. A hook that throws, or\n   * answers in the wrong shape, stops the run as a plugin that fails to load\n   * does: an archival decided without the check it asked for is not one to\n   * trust.\n   *\n   * A hook is handed a frozen copy of the refusals, and its waivers are\n   * matched against the plan's own. Handed the plan's list, a hook could drop\n   * a refusal from it, or relabel an open task as a protected file and waive\n   * that, and so lift what only spec-brief may; writing to the copy throws,\n   * which stops the run like any failing hook.\n   */\n  private async waive(plan: Plan, base: string | null, commit: string | null, strict: boolean): Promise<Plan> {\n    if (!plan.blocking.some((f) => WAIVABLE.includes(f.rule))) return plan;\n    const context = frozenCopy({\n      root: this.root,\n      brief: { id: plan.brief.id, file: plan.brief.file, text: plan.brief.text },\n      findings: plan.blocking,\n      base,\n      commit,\n    });\n    const waivers: { plugin: string; waiver: Waiver }[] = [];\n    for (const plugin of await this.loadedPlugins()) {\n      if (plugin.waive === undefined) continue;\n      let answer: unknown;\n      try {\n        answer = await plugin.waive(context);\n      } catch (error) {\n        throw new ConfigError(`plugin \"${plugin.name}\"`, [`\"waive\" failed: ${error instanceof Error ? error.message : String(error)}`]);\n      }\n      for (const waiver of asWaivers(answer, plugin.name)) waivers.push({ plugin: plugin.name, waiver });\n    }\n    return applyWaivers(plan, waivers, strict);\n  }\n\n  planUnarchive(reference: string, options: UnarchiveRequest = {}): Plan {\n    return planUnarchive(this.corpus, this.find(reference), options);\n  }\n\n  /** Executes a plan and reads the briefs again. A refused plan is never applied. */\n  async apply(plan: Plan): Promise<void> {\n    if (plan.blocking.length > 0) {\n      throw new EngineError('refused', `${plan.action} of ${plan.brief.file} is refused: ${(plan.blocking[0] as Finding).message}`);\n    }\n    if (plan.done) return;\n    await applyPlan(this.fs, plan.ops);\n    await this.load();\n  }\n\n  /** Scaffolds a brief and writes it; the file is new, or nothing is written. */\n  async create(options: NewOptions): Promise<{ file: string; content: string }> {\n    const title = options.title.trim();\n    if (title === '') throw new EngineError('invalid', 'a brief needs a title');\n    const id = options.id ?? nextId(this.corpus);\n    if (id === null) throw new EngineError('invalid', 'the ids here are not numbers, so there is no next one; pass --id');\n    if (/[\\s/\\\\]/.test(id) || id.includes(this.config.id.separator)) {\n      throw new EngineError('invalid', `\"${id}\" cannot be an id: no whitespace, slashes or \"${this.config.id.separator}\"`);\n    }\n    if (findBriefs(this.corpus, id).some((b) => b.id !== null)) throw new EngineError('exists', `the id \"${id}\" is taken`);\n    if (options.type !== undefined && typeSections(this.config, options.type) === undefined) {\n      const names = Object.keys(this.config.types);\n      throw new EngineError('invalid', `\"${options.type}\" is not a brief type here; use one of ${names.join(', ') || '(none)'}`);\n    }\n    const date = options.date ?? today();\n    if (!isDate(date)) throw new EngineError('invalid', `\"${date}\" is not a date written YYYY-MM-DD`);\n    const template = this.config.template === null ? null : await this.fs.read(this.config.template);\n    if (this.config.template !== null && template === null) {\n      throw new EngineError('not-found', `the template ${this.config.template} does not exist`);\n    }\n    const content = renderNewBrief(\n      this.config,\n      { id, title, date, type: options.type, wave: options.wave, dependsOn: options.dependsOn },\n      template,\n    );\n    const dir = normalisePath(this.config.briefs);\n    const file = `${dir}/${fileNameFor(this.config, id, title)}`;\n    if (await this.fs.exists(file)) throw new EngineError('exists', `${file} already exists`);\n    await this.fs.write(file, content);\n    await this.load();\n    return { file, content };\n  }\n}\n"]}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The engine: one repository's briefs, with the operations the CLI offers and\n * the same ones for a harness or an orchestrator that would rather call a\n * function than parse a terminal.\n *\n * This module and the CLI are where the pieces meet their implementations -\n * the real filesystem, the real git, the plugins a configuration names.\n * Everything they compose is a pure function that takes those as arguments,\n * so an engine can equally run over a `MemoryFileSystem` and no git at all.\n */\n\nimport { access } from 'node:fs/promises';\nimport { basename, dirname, relative, resolve, sep } from 'node:path';\n\nimport { applyPlan } from './apply.js';\nimport {\n  applyWaivers,\n  planArchive,\n  type Plan,\n  planUnarchive,\n  type PullRequest,\n  type UnarchiveRequest,\n  type Unmeasured,\n  WAIVABLE,\n  type Waiver,\n} from './archive.js';\nimport type { Brief } from './brief.js';\nimport { collisionFindings, collisions, type CollisionOptions, type CollisionReport } from './collisions.js';\nimport { type Config, ConfigError, DEFAULT_CONFIG, locateConfig, parseConfig, typeSections } from './config.js';\nimport { buildCorpus, type Corpus, findBriefs, isReady, pendingDependencies, type SourceFile } from './corpus.js';\nimport { canonicalPath, type FileSystem, NodeFileSystem } from './fs.js';\nimport { type CommitInfo, type FileChange, type Git, NodeGit, pullRequestUrl } from './git.js';\nimport { matchGlob, parseGlob } from './glob.js';\nimport { normalisePath } from './links.js';\nimport { lint, type Plugin } from './lint.js';\nimport { asWaivers, loadPlugins } from './plugins.js';\nimport { fileNameFor, nextId, renderNewBrief } from './scaffold.js';\nimport { planWaves, type Schedule, schedule, scheduleFindings, type ScheduleOptions } from './schedule.js';\nimport type { Finding, Phase } from './types.js';\n\nexport class EngineError extends Error {\n  readonly code: 'not-found' | 'ambiguous' | 'invalid' | 'refused' | 'exists';\n\n  constructor(code: EngineError['code'], message: string) {\n    super(message);\n    this.name = 'EngineError';\n    this.code = code;\n  }\n}\n\nexport interface EngineSetup {\n  /** Absolute root: the directory holding the configuration. */\n  readonly root: string;\n  readonly config: Config;\n  /** Repository-relative configuration path, or `null` when the defaults apply. */\n  readonly configFile: string | null;\n  readonly fs: FileSystem;\n  readonly git: Git | null;\n  readonly plugins?: readonly Plugin[];\n}\n\nexport interface OpenOptions {\n  /** Where discovery starts. Defaults to the process's directory. */\n  readonly cwd?: string;\n  /** An explicit configuration file; discovery is skipped. */\n  readonly config?: string | undefined;\n  /** Use the defaults even where a configuration file exists. */\n  readonly noConfig?: boolean;\n  /** `null` runs without git. Defaults to git when the root is inside a working tree. */\n  readonly git?: Git | null;\n  readonly fs?: FileSystem;\n}\n\nexport interface ArchiveOptions {\n  readonly pr?: number | undefined;\n  /** The commit the round landed as. */\n  readonly commit?: string | undefined;\n  /** The branch the round started from; the diff runs from its merge base. */\n  readonly base?: string | undefined;\n  readonly summary?: string | undefined;\n  readonly date?: string | undefined;\n  readonly allowDirty?: boolean | undefined;\n  readonly strict?: boolean | undefined;\n  /** Leave git out, even where there is a repository. */\n  readonly noGit?: boolean | undefined;\n}\n\nexport interface NewOptions {\n  readonly title: string;\n  readonly id?: string | undefined;\n  readonly type?: string | undefined;\n  readonly wave?: number | undefined;\n  readonly dependsOn?: readonly string[] | undefined;\n  readonly date?: string | undefined;\n}\n\nasync function exists(path: string): Promise<boolean> {\n  try {\n    await access(path);\n    return true;\n  } catch {\n    // Absent, or not to be reached: the search goes on either way. An empty\n    // catch would answer `undefined`, which the search reads the same.\n    return false;\n  }\n}\n\n/** The last second of 9999-12-31, the last date written YYYY-MM-DD. */\nconst LAST_SECOND = 253402300799;\n\n/**\n * Today, in UTC. `SOURCE_DATE_EPOCH` wins where it is set, which is what makes\n * a banner written in a reproducible pipeline reproducible.\n *\n * Set, it is what its specification says it is: whole seconds since\n * 1970-01-01 in digits alone, as `date +%s` prints them, and here no later\n * than the last date written YYYY-MM-DD. Anything else is refused by name,\n * an empty value too, which is what a command substitution that failed\n * leaves. Read as unset, it had the run write the clock's date where a\n * pipeline asked for its own, and say nothing.\n */\nexport function today(env: Readonly<Record<string, string | undefined>> = process.env): string {\n  const epoch = env['SOURCE_DATE_EPOCH'];\n  let when = new Date();\n  if (epoch !== undefined) {\n    // Quoted as JSON, so a newline or a tab in it is seen, and the refusal stays one line.\n    const held = `SOURCE_DATE_EPOCH is ${JSON.stringify(epoch)}`;\n    if (!/^\\d+$/.test(epoch)) {\n      throw new EngineError('invalid', `${held}, which is not a whole number of seconds since 1970-01-01; set it to one in digits alone, as \"date +%s\" prints it, or unset it`);\n    }\n    if (Number(epoch) > LAST_SECOND) {\n      throw new EngineError('invalid', `${held}, which is after 9999-12-31, the last date written YYYY-MM-DD; set it to ${LAST_SECOND} or less, or unset it`);\n    }\n    when = new Date(Number(epoch) * 1000);\n  }\n  return when.toISOString().slice(0, 10);\n}\n\n/**\n * A deep copy of a value in which every object and array is frozen. Plain\n * data only, as `structuredClone` takes it; the recursion ends at the data's\n * own depth.\n */\nfunction frozenCopy<T>(value: T): T {\n  const freeze = (item: unknown): void => {\n    if (typeof item !== 'object' || item === null) return;\n    for (const child of Object.values(item)) freeze(child);\n    Object.freeze(item);\n  };\n  const copy = structuredClone(value);\n  freeze(copy);\n  return copy;\n}\n\nexport function isDate(text: string): boolean {\n  // The shape keeps out the one other text that survives the round trip\n  // below: a year past 9999 with a month, \"+010000-01\". Its anchors are for\n  // the reader, since nothing longer than a date comes back as it went in.\n  if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(text)) return false;\n  const parsed = new Date(`${text}T00:00:00Z`);\n  return !Number.isNaN(parsed.getTime()) && parsed.toISOString().slice(0, 10) === text;\n}\n\nexport class BriefEngine {\n  readonly root: string;\n  readonly config: Config;\n  readonly configFile: string | null;\n  readonly fs: FileSystem;\n  readonly git: Git | null;\n  private plugins: readonly Plugin[] | undefined;\n  private loaded: Corpus | undefined;\n  /** Known once the briefs are read, which every command does before it asks. */\n  private missingBriefs: boolean | undefined;\n\n  constructor(setup: EngineSetup) {\n    this.root = setup.root;\n    this.config = setup.config;\n    this.configFile = setup.configFile;\n    this.fs = setup.fs;\n    this.git = setup.git;\n    this.plugins = setup.plugins;\n  }\n\n  /**\n   * Finds the configuration, the root it defines and the repository around it,\n   * and reads every brief. The root is the directory holding the\n   * configuration; without one it is the working tree's top, or `cwd`.\n   */\n  static async open(options: OpenOptions = {}): Promise<BriefEngine> {\n    // Named as git names them, so the root and the work tree compare.\n    const cwd = await canonicalPath(resolve(options.cwd ?? process.cwd()));\n    const explicit = options.config === undefined ? undefined : await canonicalPath(resolve(cwd, options.config));\n    const configPath = options.noConfig === true ? undefined : (explicit ?? (await locateConfig(cwd, exists)));\n    // Asking git costs a process; without git there is nothing to ask.\n    const toplevel = options.git === null ? null : await NodeGit.toplevel(cwd);\n    const root = configPath === undefined ? (toplevel ?? cwd) : dirname(configPath);\n    let config = DEFAULT_CONFIG;\n    if (configPath !== undefined) {\n      const text = await new NodeFileSystem(root).read(basename(configPath)).catch((error: NodeJS.ErrnoException) => {\n        // A directory of that name, found or named with --config, is a\n        // configuration that does not load, and no defect to report a stack for.\n        if (error.code !== 'EISDIR') throw error;\n        throw new ConfigError(relative(cwd, configPath), ['is a directory, not a configuration file']);\n      });\n      if (text === null) throw new EngineError('not-found', `${configPath} does not exist`);\n      config = parseConfig(text, relative(cwd, configPath));\n    }\n    // Outside the work tree is its parent or a path through it, \"..\", \"../x\":\n    // a directory inside it may itself be named \"..drafts\".\n    const fromTop = toplevel === null ? null : relative(toplevel, root);\n    const inTree = fromTop !== null && fromTop !== '..' && !fromTop.startsWith(`..${sep}`);\n    const engine = new BriefEngine({\n      root,\n      config,\n      // The root is the configuration's directory, so its path from there is its name.\n      configFile: configPath === undefined ? null : basename(configPath),\n      fs: options.fs ?? new NodeFileSystem(root),\n      git: options.git === undefined ? (inTree ? new NodeGit(root) : null) : options.git,\n    });\n    await engine.load();\n    return engine;\n  }\n\n  get corpus(): Corpus {\n    if (this.loaded === undefined) throw new Error('the engine has not loaded its briefs; call load() first');\n    return this.loaded;\n  }\n\n  /** Reads every brief again, as after an archival. */\n  async load(): Promise<Corpus> {\n    const files: SourceFile[] = [];\n    const accept = parseGlob(this.config.files);\n    const reject = this.config.exclude.map((pattern) => parseGlob(pattern));\n    const isBrief = (name: string): boolean =>\n      accept.ok && matchGlob(accept.glob, name) && !reject.some((r) => r.ok && matchGlob(r.glob, name));\n    const read = async (directory: string, phase: Phase): Promise<boolean> => {\n      const dir = normalisePath(directory);\n      const names = await this.fs.list(dir);\n      if (names === null) return false;\n      for (const name of names) {\n        if (!isBrief(name)) continue;\n        const path = dir === '' ? name : `${dir}/${name}`;\n        const text = await this.fs.read(path);\n        // A file listed a moment ago and gone now was removed under the run; there is nothing to read.\n        if (text !== null) files.push({ path, text, phase });\n      }\n      return true;\n    };\n    this.missingBriefs = !(await read(this.config.briefs, 'live'));\n    await read(this.config.archive, 'archived');\n    this.loaded = buildCorpus(files, this.config);\n    return this.loaded;\n  }\n\n  /**\n   * Refuses to report on a briefs directory that does not exist. A check over\n   * nothing looks exactly like a clean one, and the likelier cause is a\n   * configuration pointing at the wrong place.\n   */\n  requireBriefs(): void {\n    if (this.missingBriefs) {\n      throw new EngineError('not-found', `${normalisePath(this.config.briefs)}/ does not exist; run \"spec-brief init\", or set \"briefs\" in the configuration`);\n    }\n  }\n\n  /** The plugins the configuration names, loaded once. */\n  async loadedPlugins(): Promise<readonly Plugin[]> {\n    this.plugins ??= await loadPlugins(this.config.plugins, this.root);\n    return this.plugins;\n  }\n\n  /** The one brief a reference names: an id, a file name or a path. */\n  find(reference: string): Brief {\n    const found = findBriefs(this.corpus, reference);\n    if (found.length === 0) throw new EngineError('not-found', `no brief is named \"${reference}\"`);\n    if (found.length > 1) {\n      throw new EngineError('ambiguous', `\"${reference}\" names ${found.length} briefs: ${found.map((b) => b.file).join(', ')}`);\n    }\n    return found[0] as Brief;\n  }\n\n  /** The files git sees, or every file when there is no git; `null` when neither can be read. */\n  async repoFiles(): Promise<string[] | null> {\n    try {\n      return this.git === null ? await this.fs.walk() : await this.git.files();\n    } catch {\n      return null;\n    }\n  }\n\n  async lint(references: readonly string[] = []): Promise<Finding[]> {\n    const only = references.length === 0 ? undefined : references.map((r) => this.find(r));\n    return lint(this.corpus, { plugins: await this.loadedPlugins(), repoFiles: await this.repoFiles(), ...(only ? { only } : {}) });\n  }\n\n  async collisions(options: CollisionOptions = {}): Promise<{ report: CollisionReport; findings: Finding[] }> {\n    const report = collisions(this.corpus, { repoFiles: await this.repoFiles(), ...options });\n    return { report, findings: collisionFindings(this.corpus, report) };\n  }\n\n  async schedule(options: ScheduleOptions = {}): Promise<{ schedule: Schedule; findings: Finding[] }> {\n    const computed = schedule(this.corpus, { repoFiles: await this.repoFiles(), ...options });\n    return { schedule: computed, findings: scheduleFindings(this.corpus, computed) };\n  }\n\n  /**\n   * Writes each brief's proposed wave into its front matter, every other line\n   * as it was, as one transaction. Refused, with nothing written, when the\n   * dependencies form a cycle or a front matter cannot be edited.\n   */\n  async writeWaves(computed: Schedule): Promise<{ written: string[]; refused: Finding[] }> {\n    const plan = planWaves(computed);\n    if (computed.cycles.length > 0 || plan.refused.length > 0) return { written: [], refused: [...plan.refused] };\n    await applyPlan(this.fs, plan.ops);\n    await this.load();\n    return { written: plan.ops.map((op) => op.path), refused: [] };\n  }\n\n  /** Live briefs that can run now: every dependency archived, and neither a draft nor deferred. */\n  ready(): Brief[] {\n    return this.corpus.live.filter((b) => isReady(this.corpus, b));\n  }\n\n  /** The live dependencies holding a brief back. */\n  waitingOn(brief: Brief): string[] {\n    return pendingDependencies(this.corpus, brief);\n  }\n\n  async planArchive(reference: string, options: ArchiveOptions = {}): Promise<Plan> {\n    const brief = this.find(reference);\n    const date = options.date ?? today();\n    if (!isDate(date)) throw new EngineError('invalid', `\"${date}\" is not a date written YYYY-MM-DD`);\n    if (options.noGit === true && (options.commit !== undefined || options.base !== undefined)) {\n      throw new EngineError('invalid', 'a commit or a base needs git; drop --no-git, or drop --commit and --base');\n    }\n    const git = options.noGit === true ? null : this.git;\n    const base = options.base ?? this.config.archiving.base ?? undefined;\n    const findings = await this.lint();\n\n    let commit: CommitInfo | undefined;\n    let changes: FileChange[] | undefined;\n    let unmeasured: Unmeasured | undefined;\n    let dirty: string[] | undefined;\n    let pr: PullRequest | undefined;\n    if (git !== null) {\n      const revision = options.commit ?? (base === undefined ? undefined : 'HEAD');\n      if (revision !== undefined) {\n        commit = (await git.commit(revision)) ?? undefined;\n        if (commit === undefined) throw new EngineError('not-found', `\"${revision}\" names no commit`);\n        let from: string | null = null;\n        if (base !== undefined) {\n          from = await git.mergeBase(base, commit.sha);\n          // No merge base: a base with a history of its own is diffed from\n          // directly, and one that names nothing is a typo to report, not a\n          // diff for git to fail.\n          if (from === null) {\n            if ((await git.commit(base)) === null) {\n              throw new EngineError('not-found', `the base \"${base}\" names no commit; check --base and \"archiving.base\"`);\n            }\n            from = base;\n          }\n        }\n        // A commit that is its own merge base with the base branch is already\n        // in it: the diff is empty whatever the round changed, and an empty\n        // diff would pass every scope check without measuring one.\n        if (from === commit.sha) unmeasured = { reason: 'merged', base: base as string, commit: commit.sha };\n        else changes = await git.changes(from, commit.sha);\n      }\n      // With neither a commit nor a base, nothing was read, and the planner\n      // says so itself of a request that brings no changes and no reason.\n      dirty = await git.dirty();\n    } else {\n      unmeasured = { reason: 'git' };\n    }\n    if (options.pr !== undefined) {\n      pr = { number: options.pr, url: git === null ? null : pullRequestUrl(await git.remoteUrl('origin'), options.pr) };\n    }\n    const plan = planArchive(this.corpus, brief, {\n      date,\n      summary: options.summary,\n      pr,\n      commit,\n      changes,\n      unmeasured,\n      dirty,\n      allowDirty: options.allowDirty,\n      strict: options.strict,\n      findings,\n    });\n    return this.waive(plan, base ?? null, commit?.sha ?? null, options.strict === true);\n  }\n\n  /**\n   * Asks each plugin with a `waive` hook which of a plan's refusals its own\n   * check lifts, and turns those into notes. Asked only when the plan has a\n   * refusal a plugin may lift: a hook may read git and verify signatures, and a\n   * plan with nothing to waive has no question for it. A hook that throws, or\n   * answers in the wrong shape, stops the run as a plugin that fails to load\n   * does: an archival decided without the check it asked for is not one to\n   * trust.\n   *\n   * A hook is handed a frozen copy of the refusals, and its waivers are\n   * matched against the plan's own. Handed the plan's list, a hook could drop\n   * a refusal from it, or relabel an open task as a protected file and waive\n   * that, and so lift what only spec-brief may; writing to the copy throws,\n   * which stops the run like any failing hook.\n   */\n  private async waive(plan: Plan, base: string | null, commit: string | null, strict: boolean): Promise<Plan> {\n    if (!plan.blocking.some((f) => WAIVABLE.includes(f.rule))) return plan;\n    const context = frozenCopy({\n      root: this.root,\n      brief: { id: plan.brief.id, file: plan.brief.file, text: plan.brief.text },\n      findings: plan.blocking,\n      base,\n      commit,\n    });\n    const waivers: { plugin: string; waiver: Waiver }[] = [];\n    for (const plugin of await this.loadedPlugins()) {\n      if (plugin.waive === undefined) continue;\n      let answer: unknown;\n      try {\n        answer = await plugin.waive(context);\n      } catch (error) {\n        throw new ConfigError(`plugin \"${plugin.name}\"`, [`\"waive\" failed: ${error instanceof Error ? error.message : String(error)}`]);\n      }\n      for (const waiver of asWaivers(answer, plugin.name)) waivers.push({ plugin: plugin.name, waiver });\n    }\n    return applyWaivers(plan, waivers, strict);\n  }\n\n  planUnarchive(reference: string, options: UnarchiveRequest = {}): Plan {\n    return planUnarchive(this.corpus, this.find(reference), options);\n  }\n\n  /** Executes a plan and reads the briefs again. A refused plan is never applied. */\n  async apply(plan: Plan): Promise<void> {\n    if (plan.blocking.length > 0) {\n      throw new EngineError('refused', `${plan.action} of ${plan.brief.file} is refused: ${(plan.blocking[0] as Finding).message}`);\n    }\n    if (plan.done) return;\n    await applyPlan(this.fs, plan.ops);\n    await this.load();\n  }\n\n  /** Scaffolds a brief and writes it; the file is new, or nothing is written. */\n  async create(options: NewOptions): Promise<{ file: string; content: string }> {\n    const title = options.title.trim();\n    if (title === '') throw new EngineError('invalid', 'a brief needs a title');\n    const id = options.id ?? nextId(this.corpus);\n    if (id === null) throw new EngineError('invalid', 'the ids here are not numbers, so there is no next one; pass --id');\n    if (/[\\s/\\\\]/.test(id) || id.includes(this.config.id.separator)) {\n      throw new EngineError('invalid', `\"${id}\" cannot be an id: no whitespace, slashes or \"${this.config.id.separator}\"`);\n    }\n    if (findBriefs(this.corpus, id).some((b) => b.id !== null)) throw new EngineError('exists', `the id \"${id}\" is taken`);\n    if (options.type !== undefined && typeSections(this.config, options.type) === undefined) {\n      const names = Object.keys(this.config.types);\n      throw new EngineError('invalid', `\"${options.type}\" is not a brief type here; use one of ${names.join(', ') || '(none)'}`);\n    }\n    const date = options.date ?? today();\n    if (!isDate(date)) throw new EngineError('invalid', `\"${date}\" is not a date written YYYY-MM-DD`);\n    const template = this.config.template === null ? null : await this.fs.read(this.config.template);\n    if (this.config.template !== null && template === null) {\n      throw new EngineError('not-found', `the template ${this.config.template} does not exist`);\n    }\n    const content = renderNewBrief(\n      this.config,\n      { id, title, date, type: options.type, wave: options.wave, dependsOn: options.dependsOn },\n      template,\n    );\n    const dir = normalisePath(this.config.briefs);\n    const file = `${dir}/${fileNameFor(this.config, id, title)}`;\n    if (await this.fs.exists(file)) throw new EngineError('exists', `${file} already exists`);\n    await this.fs.write(file, content);\n    await this.load();\n    return { file, content };\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@descent-vtt/spec-brief",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "Lifecycle management for task briefs: lint the contract, map parallel collisions, and archive a round in one atomic command.",
   "keywords": [
     "agents",