@descent-vtt/spec-brief 0.1.0 → 0.2.0

package/dist/collisions.js

@@ -4,63 +4,70 @@
  *
  * Scopes are compared as globs, not as strings. `src/auth/**` and
  * `src/**\/session.ts` share no prefix a string comparison would see and both
- * cover `src/auth/session.ts`; the intersection finds that, and names the file.
- * A brief that declares no scope cannot be proven apart from anything, so it
- * is reported as unscoped rather than silently counted as safe.
+ * cover `src/auth/session.ts`; the witness search finds that, and names the
+ * file. What a brief protects it will not write, so a file either brief of a
+ * pair protects is no collision. A brief that declares no scope cannot be
+ * proven apart from anything, so it is reported as unscoped rather than
+ * silently counted as safe, and a pair the search could not decide is reported
+ * as undecided rather than as either.
+ *
+ * Two briefs that collide are one defect however many of their patterns
+ * meet: they are fixed together, by a wave, a dependency or a narrower scope.
+ * So a pair is one collision, carrying every pair of patterns that meets.
  */
 import { lineOfField } from './brief.js';
-import { globBase, intersectGlobs, parseGlob } from './glob.js';
-import { severityOf } from './lint.js';
-import { COLLISION_RULES } from './rules.js';
-function scopes(brief, isFile) {
-    return brief.affectedFiles.flatMap((pattern) => {
-        const parsed = parseGlob(pattern, { isFile });
-        return parsed.ok ? [{ pattern, glob: parsed.glob }] : [];
-    });
-}
-function matrix(wave, briefs, isFile) {
+import { waitingOnDeferred } from './corpus.js';
+import { globBases, readingIn, WITNESS_BUDGET } from './glob.js';
+import { configuredSeverity } from './lint.js';
+import { meet, scopeOf } from './scope.js';
+import { inWords } from './text.js';
+function matrix(wave, briefs, scopes, budget) {
     const collisions = [];
+    const undecided = [];
     const shared = [];
-    const scoped = briefs.map((brief) => ({ brief, scopes: scopes(brief, isFile) }));
+    const scoped = briefs.map((brief) => scopes.get(brief));
     for (let i = 0; i < scoped.length; i += 1) {
         for (let j = i + 1; j < scoped.length; j += 1) {
             const left = scoped[i];
             const right = scoped[j];
-            const found = [];
-            for (const x of left.scopes) {
-                for (const y of right.scopes) {
-                    const witness = intersectGlobs(x.glob, y.glob);
-                    if (witness !== null)
-                        found.push({ a: left.brief, b: right.brief, patterns: [x.pattern, y.pattern], witness });
-                }
+            const meeting = meet(left, right, budget);
+            if (meeting.overlaps.length > 0) {
+                collisions.push({ a: left.brief, b: right.brief, overlaps: meeting.overlaps });
+                continue;
             }
-            collisions.push(...found);
-            if (found.length > 0)
+            if (meeting.undecided.length > 0) {
+                undecided.push({ a: left.brief, b: right.brief, patterns: meeting.undecided });
                 continue;
-            const leftDirs = new Set(left.scopes.map((s) => globBase(s.glob)).filter((d) => d !== ''));
-            const common = [...new Set(right.scopes.map((s) => globBase(s.glob)))].filter((d) => leftDirs.has(d)).sort();
-            for (const directory of common)
-                shared.push({ a: left.brief, b: right.brief, directory });
+            }
+            const leftDirs = new Set(left.affected.flatMap((s) => globBases(s.glob)).filter((d) => d !== ''));
+            const directories = [...new Set(right.affected.flatMap((s) => globBases(s.glob)))].filter((d) => leftDirs.has(d)).sort();
+            if (directories.length > 0)
+                shared.push({ a: left.brief, b: right.brief, directories });
         }
     }
-    const unscoped = briefs.length > 1 ? scoped.filter((s) => s.scopes.length === 0).map((s) => s.brief) : [];
-    return { wave, briefs, collisions, shared, unscoped };
+    const unscoped = briefs.length > 1 ? scoped.filter((s) => s.affected.length === 0).map((s) => s.brief) : [];
+    return { wave, briefs, collisions, undecided, shared, unscoped };
 }
 export function collisions(corpus, options = {}) {
-    const files = options.repoFiles === undefined || options.repoFiles === null ? null : new Set(options.repoFiles);
-    const isFile = files === null ? undefined : (path) => files.has(path);
+    const reading = readingIn(options.repoFiles ?? null);
+    const budget = options.budget ?? WITNESS_BUDGET;
+    const deferred = corpus.live.filter((b) => b.status === 'deferred');
+    const waiting = waitingOnDeferred(corpus);
+    const held = new Set(waiting.map((w) => w.brief));
+    const live = corpus.live.filter((b) => b.status !== 'deferred' && !held.has(b));
+    const scopes = new Map(live.map((brief) => [brief, scopeOf(brief, reading)]));
     if (options.all === true)
-        return { waves: [matrix(null, corpus.live, isFile)], unscheduled: [] };
+        return { waves: [matrix(null, live, scopes, budget)], unscheduled: [], deferred, waiting };
     const byWave = new Map();
     const unscheduled = [];
-    for (const brief of corpus.live) {
+    for (const brief of live) {
         if (brief.wave === null)
             unscheduled.push(brief);
         else
             byWave.set(brief.wave, [...(byWave.get(brief.wave) ?? []), brief]);
     }
-    const waves = [...byWave.keys()].sort((a, b) => a - b).map((wave) => matrix(wave, byWave.get(wave), isFile));
-    return { waves, unscheduled };
+    const waves = [...byWave.keys()].sort((a, b) => a - b).map((wave) => matrix(wave, byWave.get(wave), scopes, budget));
+    return { waves, unscheduled, deferred, waiting };
 }
 function label(brief) {
     return brief.id ?? brief.name;
@@ -68,27 +75,44 @@ function label(brief) {
 function where(wave) {
     return wave === null ? 'among the live briefs' : `in wave ${wave}`;
 }
+function collisionMessage(c, wave) {
+    if (c.overlaps.length === 1) {
+        const only = c.overlaps[0];
+        return `"${only.patterns[1]}" overlaps ${label(c.a)}'s "${only.patterns[0]}" ${where(wave)}; both cover ${only.witness}`;
+    }
+    const each = c.overlaps.map((o) => `"${o.patterns[1]}" and ${label(c.a)}'s "${o.patterns[0]}" both cover ${o.witness}`);
+    return `overlaps ${label(c.a)} ${where(wave)} through ${c.overlaps.length} pairs of patterns: ${each.join('; ')}`;
+}
+/** A pair whose collision the search could not decide, as one finding on the later brief. */
+export function undecidedFinding(severity, a, b, patterns, wave) {
+    const pairs = patterns.map(([x, y]) => `"${y}" and ${label(a)}'s "${x}"`);
+    return {
+        rule: 'collision-undecided',
+        severity,
+        message: `whether it can write a file ${label(a)} writes ${where(wave)} is undecided: the search met its budget for ${inWords(pairs)}`,
+        file: b.file,
+        line: lineOfField(b, 'affectedFiles') + 1,
+        brief: b.id ?? undefined,
+        hint: 'narrow one of the patterns, or run the two in different waves',
+    };
+}
 /**
- * The report as findings. One collision is one finding, placed on the later
- * brief of the pair, which is usually the one still being written.
+ * The report as findings. One pair of briefs is one finding, placed on the
+ * later brief of the pair, which is usually the one still being written.
  */
 export function collisionFindings(corpus, report) {
-    const severity = (id) => {
-        const rule = COLLISION_RULES.find((r) => r.id === id);
-        const setting = severityOf(corpus, id, rule.severity);
-        return setting === 'off' ? null : setting;
-    };
     const findings = [];
-    const collision = severity('collision');
-    const unscoped = severity('unscoped');
-    const sharedDirectory = severity('shared-directory');
+    const collision = configuredSeverity(corpus, 'collision');
+    const undecided = configuredSeverity(corpus, 'collision-undecided');
+    const unscoped = configuredSeverity(corpus, 'unscoped');
+    const sharedDirectory = configuredSeverity(corpus, 'shared-directory');
     for (const wave of report.waves) {
         if (collision !== null) {
             for (const c of wave.collisions) {
                 findings.push({
                     rule: 'collision',
                     severity: collision,
-                    message: `"${c.patterns[1]}" overlaps ${label(c.a)}'s "${c.patterns[0]}" ${where(wave.wave)}; both cover ${c.witness}`,
+                    message: collisionMessage(c, wave.wave),
                     file: c.b.file,
                     line: lineOfField(c.b, 'affectedFiles') + 1,
                     brief: c.b.id ?? undefined,
@@ -96,32 +120,40 @@ export function collisionFindings(corpus, report) {
                 });
             }
         }
+        if (undecided !== null) {
+            for (const u of wave.undecided)
+                findings.push(undecidedFinding(undecided, u.a, u.b, u.patterns, wave.wave));
+        }
         if (sharedDirectory !== null) {
             for (const s of wave.shared) {
                 findings.push({
                     rule: 'shared-directory',
                     severity: sharedDirectory,
-                    message: `writes into ${s.directory}/, as ${label(s.a)} does ${where(wave.wave)}`,
+                    message: `writes into ${inWords(s.directories.map((d) => `${d}/`))}, as ${label(s.a)} does ${where(wave.wave)}`,
                     file: s.b.file,
                     line: lineOfField(s.b, 'affectedFiles') + 1,
                     brief: s.b.id ?? undefined,
+                    hint: 'check that the two do not depend on one decision in that directory; if they do, order them',
                 });
             }
         }
         if (unscoped !== null) {
-            for (const brief of wave.unscoped) {
-                findings.push({
-                    rule: 'unscoped',
-                    severity: unscoped,
-                    message: `declares no affectedFiles, so it cannot be checked against the ${wave.briefs.length - 1} other brief(s) ${where(wave.wave)}`,
-                    file: brief.file,
-                    line: 1,
-                    brief: brief.id ?? undefined,
-                    hint: 'list the files or globs this round writes under "affectedFiles"',
-                });
-            }
+            for (const brief of wave.unscoped)
+                findings.push(unscopedFinding(unscoped, brief, `the ${wave.briefs.length - 1} other brief(s) ${where(wave.wave)}`));
         }
     }
     return findings;
 }
+/** A brief with no scope, which nothing can be proved apart from. */
+export function unscopedFinding(severity, brief, others) {
+    return {
+        rule: 'unscoped',
+        severity,
+        message: `declares no affectedFiles, so it cannot be checked against ${others}`,
+        file: brief.file,
+        line: 1,
+        brief: brief.id ?? undefined,
+        hint: 'list the files or globs this round writes under "affectedFiles"',
+    };
+}
 //# sourceMappingURL=collisions.js.map

package/dist/collisions.js.map

@@ -1 +1 @@
-{"version":3,"file":"collisions.js","sourceRoot":"","sources":["../src/collisions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The collision matrix: which briefs scheduled to run side by side declare\n * scopes that can name the same file.\n *\n * Scopes are compared as globs, not as strings. `src/auth/**` and\n * `src/**\\/session.ts` share no prefix a string comparison would see and both\n * cover `src/auth/session.ts`; the intersection finds that, and names the file.\n * A brief that declares no scope cannot be proven apart from anything, so it\n * is reported as unscoped rather than silently counted as safe.\n */\n\nimport type { Brief } from './brief.js';\nimport { lineOfField } from './brief.js';\nimport type { Corpus } from './corpus.js';\nimport { type Glob, globBase, intersectGlobs, parseGlob } from './glob.js';\nimport { severityOf } from './lint.js';\nimport { COLLISION_RULES, type RuleInfo } from './rules.js';\nimport type { Finding, Severity } from './types.js';\n\nexport interface Collision {\n  readonly a: Brief;\n  readonly b: Brief;\n  readonly patterns: readonly [string, string];\n  /** A path both scopes cover. */\n  readonly witness: string;\n}\n\nexport interface SharedDirectory {\n  readonly a: Brief;\n  readonly b: Brief;\n  readonly directory: string;\n}\n\nexport interface WaveMatrix {\n  /** `null` when every live brief is compared regardless of wave. */\n  readonly wave: number | null;\n  readonly briefs: readonly Brief[];\n  readonly collisions: readonly Collision[];\n  readonly shared: readonly SharedDirectory[];\n  readonly unscoped: readonly Brief[];\n}\n\nexport interface CollisionReport {\n  readonly waves: readonly WaveMatrix[];\n  /** Live briefs with no wave, which the matrix does not place. */\n  readonly unscheduled: readonly Brief[];\n}\n\nexport interface CollisionOptions {\n  /** Compare every live brief with every other, whatever its wave. */\n  readonly all?: boolean;\n  /** Tracked files, which tell a literal file path from a directory. */\n  readonly repoFiles?: readonly string[] | null;\n}\n\nfunction scopes(brief: Brief, isFile: ((path: string) => boolean) | undefined): { pattern: string; glob: Glob }[] {\n  return brief.affectedFiles.flatMap((pattern) => {\n    const parsed = parseGlob(pattern, { isFile });\n    return parsed.ok ? [{ pattern, glob: parsed.glob }] : [];\n  });\n}\n\nfunction matrix(wave: number | null, briefs: readonly Brief[], isFile: ((path: string) => boolean) | undefined): WaveMatrix {\n  const collisions: Collision[] = [];\n  const shared: SharedDirectory[] = [];\n  const scoped = briefs.map((brief) => ({ brief, scopes: scopes(brief, isFile) }));\n  for (let i = 0; i < scoped.length; i += 1) {\n    for (let j = i + 1; j < scoped.length; j += 1) {\n      const left = scoped[i] as (typeof scoped)[number];\n      const right = scoped[j] as (typeof scoped)[number];\n      const found: Collision[] = [];\n      for (const x of left.scopes) {\n        for (const y of right.scopes) {\n          const witness = intersectGlobs(x.glob, y.glob);\n          if (witness !== null) found.push({ a: left.brief, b: right.brief, patterns: [x.pattern, y.pattern], witness });\n        }\n      }\n      collisions.push(...found);\n      if (found.length > 0) continue;\n      const leftDirs = new Set(left.scopes.map((s) => globBase(s.glob)).filter((d) => d !== ''));\n      const common = [...new Set(right.scopes.map((s) => globBase(s.glob)))].filter((d) => leftDirs.has(d)).sort();\n      for (const directory of common) shared.push({ a: left.brief, b: right.brief, directory });\n    }\n  }\n  const unscoped = briefs.length > 1 ? scoped.filter((s) => s.scopes.length === 0).map((s) => s.brief) : [];\n  return { wave, briefs, collisions, shared, unscoped };\n}\n\nexport function collisions(corpus: Corpus, options: CollisionOptions = {}): CollisionReport {\n  const files = options.repoFiles === undefined || options.repoFiles === null ? null : new Set(options.repoFiles);\n  const isFile = files === null ? undefined : (path: string): boolean => files.has(path);\n  if (options.all === true) return { waves: [matrix(null, corpus.live, isFile)], unscheduled: [] };\n  const byWave = new Map<number, Brief[]>();\n  const unscheduled: Brief[] = [];\n  for (const brief of corpus.live) {\n    if (brief.wave === null) unscheduled.push(brief);\n    else byWave.set(brief.wave, [...(byWave.get(brief.wave) ?? []), brief]);\n  }\n  const waves = [...byWave.keys()].sort((a, b) => a - b).map((wave) => matrix(wave, byWave.get(wave) as Brief[], isFile));\n  return { waves, unscheduled };\n}\n\nfunction label(brief: Brief): string {\n  return brief.id ?? brief.name;\n}\n\nfunction where(wave: number | null): string {\n  return wave === null ? 'among the live briefs' : `in wave ${wave}`;\n}\n\n/**\n * The report as findings. One collision is one finding, placed on the later\n * brief of the pair, which is usually the one still being written.\n */\nexport function collisionFindings(corpus: Corpus, report: CollisionReport): Finding[] {\n  const severity = (id: string): Severity | null => {\n    const rule = COLLISION_RULES.find((r) => r.id === id) as RuleInfo;\n    const setting = severityOf(corpus, id, rule.severity);\n    return setting === 'off' ? null : setting;\n  };\n  const findings: Finding[] = [];\n  const collision = severity('collision');\n  const unscoped = severity('unscoped');\n  const sharedDirectory = severity('shared-directory');\n  for (const wave of report.waves) {\n    if (collision !== null) {\n      for (const c of wave.collisions) {\n        findings.push({\n          rule: 'collision',\n          severity: collision,\n          message: `\"${c.patterns[1]}\" overlaps ${label(c.a)}'s \"${c.patterns[0]}\" ${where(wave.wave)}; both cover ${c.witness}`,\n          file: c.b.file,\n          line: lineOfField(c.b, 'affectedFiles') + 1,\n          brief: c.b.id ?? undefined,\n          hint: `run them in different waves, make one depend on the other, or narrow a scope`,\n        });\n      }\n    }\n    if (sharedDirectory !== null) {\n      for (const s of wave.shared) {\n        findings.push({\n          rule: 'shared-directory',\n          severity: sharedDirectory,\n          message: `writes into ${s.directory}/, as ${label(s.a)} does ${where(wave.wave)}`,\n          file: s.b.file,\n          line: lineOfField(s.b, 'affectedFiles') + 1,\n          brief: s.b.id ?? undefined,\n        });\n      }\n    }\n    if (unscoped !== null) {\n      for (const brief of wave.unscoped) {\n        findings.push({\n          rule: 'unscoped',\n          severity: unscoped,\n          message: `declares no affectedFiles, so it cannot be checked against the ${wave.briefs.length - 1} other brief(s) ${where(wave.wave)}`,\n          file: brief.file,\n          line: 1,\n          brief: brief.id ?? undefined,\n          hint: 'list the files or globs this round writes under \"affectedFiles\"',\n        });\n      }\n    }\n  }\n  return findings;\n}\n"]}
+{"version":3,"file":"collisions.js","sourceRoot":"","sources":["../src/collisions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The collision matrix: which briefs scheduled to run side by side declare\n * scopes that can name the same file.\n *\n * Scopes are compared as globs, not as strings. `src/auth/**` and\n * `src/**\\/session.ts` share no prefix a string comparison would see and both\n * cover `src/auth/session.ts`; the witness search finds that, and names the\n * file. What a brief protects it will not write, so a file either brief of a\n * pair protects is no collision. A brief that declares no scope cannot be\n * proven apart from anything, so it is reported as unscoped rather than\n * silently counted as safe, and a pair the search could not decide is reported\n * as undecided rather than as either.\n *\n * Two briefs that collide are one defect however many of their patterns\n * meet: they are fixed together, by a wave, a dependency or a narrower scope.\n * So a pair is one collision, carrying every pair of patterns that meets.\n */\n\nimport type { Brief } from './brief.js';\nimport { lineOfField } from './brief.js';\nimport { type Corpus, waitingOnDeferred, type Waiting } from './corpus.js';\nimport { globBases, readingIn, WITNESS_BUDGET } from './glob.js';\nimport { configuredSeverity } from './lint.js';\nimport { meet, type Overlap, type Scope, scopeOf } from './scope.js';\nimport { inWords } from './text.js';\nimport type { Finding, Severity } from './types.js';\n\nexport type { Overlap } from './scope.js';\n\nexport interface Collision {\n  readonly a: Brief;\n  readonly b: Brief;\n  /** Every pair of patterns that meets, `a`'s first; never empty. */\n  readonly overlaps: readonly Overlap[];\n}\n\n/** Two briefs no pair of whose patterns is known to meet, and some pair the search could not decide. */\nexport interface UndecidedPair {\n  readonly a: Brief;\n  readonly b: Brief;\n  /** The pairs of patterns, `a`'s first; never empty. */\n  readonly patterns: readonly (readonly [string, string])[];\n}\n\nexport interface SharedDirectory {\n  readonly a: Brief;\n  readonly b: Brief;\n  /** The directories both write into, sorted; never empty. */\n  readonly directories: readonly string[];\n}\n\nexport interface WaveMatrix {\n  /** `null` when every live brief is compared regardless of wave. */\n  readonly wave: number | null;\n  readonly briefs: readonly Brief[];\n  readonly collisions: readonly Collision[];\n  readonly undecided: readonly UndecidedPair[];\n  readonly shared: readonly SharedDirectory[];\n  readonly unscoped: readonly Brief[];\n}\n\nexport interface CollisionReport {\n  readonly waves: readonly WaveMatrix[];\n  /** Live briefs with no wave, which the matrix does not place. */\n  readonly unscheduled: readonly Brief[];\n  /** Deferred briefs, which wait for their trigger and run in no wave. */\n  readonly deferred: readonly Brief[];\n  /**\n   * Briefs that depend on a deferred brief, or on one that waits on one. They\n   * cannot start before the deferred work, so they run in no wave either, and\n   * are compared with nothing - as `schedule` places them nowhere. By id.\n   */\n  readonly waiting: readonly Waiting[];\n}\n\nexport interface CollisionOptions {\n  /** Compare every live brief with every other, whatever its wave. */\n  readonly all?: boolean;\n  /** The files the tree holds, which say whether a literal path is a file or a directory. */\n  readonly repoFiles?: readonly string[] | null;\n  /** How many states one witness search may visit before it answers `undecided`. */\n  readonly budget?: number;\n}\n\nfunction matrix(wave: number | null, briefs: readonly Brief[], scopes: ReadonlyMap<Brief, Scope>, budget: number): WaveMatrix {\n  const collisions: Collision[] = [];\n  const undecided: UndecidedPair[] = [];\n  const shared: SharedDirectory[] = [];\n  const scoped = briefs.map((brief) => scopes.get(brief) as Scope);\n  for (let i = 0; i < scoped.length; i += 1) {\n    for (let j = i + 1; j < scoped.length; j += 1) {\n      const left = scoped[i] as Scope;\n      const right = scoped[j] as Scope;\n      const meeting = meet(left, right, budget);\n      if (meeting.overlaps.length > 0) {\n        collisions.push({ a: left.brief, b: right.brief, overlaps: meeting.overlaps });\n        continue;\n      }\n      if (meeting.undecided.length > 0) {\n        undecided.push({ a: left.brief, b: right.brief, patterns: meeting.undecided });\n        continue;\n      }\n      const leftDirs = new Set(left.affected.flatMap((s) => globBases(s.glob)).filter((d) => d !== ''));\n      const directories = [...new Set(right.affected.flatMap((s) => globBases(s.glob)))].filter((d) => leftDirs.has(d)).sort();\n      if (directories.length > 0) shared.push({ a: left.brief, b: right.brief, directories });\n    }\n  }\n  const unscoped = briefs.length > 1 ? scoped.filter((s) => s.affected.length === 0).map((s) => s.brief) : [];\n  return { wave, briefs, collisions, undecided, shared, unscoped };\n}\n\nexport function collisions(corpus: Corpus, options: CollisionOptions = {}): CollisionReport {\n  const reading = readingIn(options.repoFiles ?? null);\n  const budget = options.budget ?? WITNESS_BUDGET;\n  const deferred = corpus.live.filter((b) => b.status === 'deferred');\n  const waiting = waitingOnDeferred(corpus);\n  const held = new Set(waiting.map((w) => w.brief));\n  const live = corpus.live.filter((b) => b.status !== 'deferred' && !held.has(b));\n  const scopes = new Map(live.map((brief) => [brief, scopeOf(brief, reading)]));\n  if (options.all === true) return { waves: [matrix(null, live, scopes, budget)], unscheduled: [], deferred, waiting };\n  const byWave = new Map<number, Brief[]>();\n  const unscheduled: Brief[] = [];\n  for (const brief of live) {\n    if (brief.wave === null) unscheduled.push(brief);\n    else byWave.set(brief.wave, [...(byWave.get(brief.wave) ?? []), brief]);\n  }\n  const waves = [...byWave.keys()].sort((a, b) => a - b).map((wave) => matrix(wave, byWave.get(wave) as Brief[], scopes, budget));\n  return { waves, unscheduled, deferred, waiting };\n}\n\nfunction label(brief: Brief): string {\n  return brief.id ?? brief.name;\n}\n\nfunction where(wave: number | null): string {\n  return wave === null ? 'among the live briefs' : `in wave ${wave}`;\n}\n\nfunction collisionMessage(c: Collision, wave: number | null): string {\n  if (c.overlaps.length === 1) {\n    const only = c.overlaps[0] as Overlap;\n    return `\"${only.patterns[1]}\" overlaps ${label(c.a)}'s \"${only.patterns[0]}\" ${where(wave)}; both cover ${only.witness}`;\n  }\n  const each = c.overlaps.map((o) => `\"${o.patterns[1]}\" and ${label(c.a)}'s \"${o.patterns[0]}\" both cover ${o.witness}`);\n  return `overlaps ${label(c.a)} ${where(wave)} through ${c.overlaps.length} pairs of patterns: ${each.join('; ')}`;\n}\n\n/** A pair whose collision the search could not decide, as one finding on the later brief. */\nexport function undecidedFinding(severity: Severity, a: Brief, b: Brief, patterns: readonly (readonly [string, string])[], wave: number | null): Finding {\n  const pairs = patterns.map(([x, y]) => `\"${y}\" and ${label(a)}'s \"${x}\"`);\n  return {\n    rule: 'collision-undecided',\n    severity,\n    message: `whether it can write a file ${label(a)} writes ${where(wave)} is undecided: the search met its budget for ${inWords(pairs)}`,\n    file: b.file,\n    line: lineOfField(b, 'affectedFiles') + 1,\n    brief: b.id ?? undefined,\n    hint: 'narrow one of the patterns, or run the two in different waves',\n  };\n}\n\n/**\n * The report as findings. One pair of briefs is one finding, placed on the\n * later brief of the pair, which is usually the one still being written.\n */\nexport function collisionFindings(corpus: Corpus, report: CollisionReport): Finding[] {\n  const findings: Finding[] = [];\n  const collision = configuredSeverity(corpus, 'collision');\n  const undecided = configuredSeverity(corpus, 'collision-undecided');\n  const unscoped = configuredSeverity(corpus, 'unscoped');\n  const sharedDirectory = configuredSeverity(corpus, 'shared-directory');\n  for (const wave of report.waves) {\n    if (collision !== null) {\n      for (const c of wave.collisions) {\n        findings.push({\n          rule: 'collision',\n          severity: collision,\n          message: collisionMessage(c, wave.wave),\n          file: c.b.file,\n          line: lineOfField(c.b, 'affectedFiles') + 1,\n          brief: c.b.id ?? undefined,\n          hint: `run them in different waves, make one depend on the other, or narrow a scope`,\n        });\n      }\n    }\n    if (undecided !== null) {\n      for (const u of wave.undecided) findings.push(undecidedFinding(undecided, u.a, u.b, u.patterns, wave.wave));\n    }\n    if (sharedDirectory !== null) {\n      for (const s of wave.shared) {\n        findings.push({\n          rule: 'shared-directory',\n          severity: sharedDirectory,\n          message: `writes into ${inWords(s.directories.map((d) => `${d}/`))}, as ${label(s.a)} does ${where(wave.wave)}`,\n          file: s.b.file,\n          line: lineOfField(s.b, 'affectedFiles') + 1,\n          brief: s.b.id ?? undefined,\n          hint: 'check that the two do not depend on one decision in that directory; if they do, order them',\n        });\n      }\n    }\n    if (unscoped !== null) {\n      for (const brief of wave.unscoped) findings.push(unscopedFinding(unscoped, brief, `the ${wave.briefs.length - 1} other brief(s) ${where(wave.wave)}`));\n    }\n  }\n  return findings;\n}\n\n/** A brief with no scope, which nothing can be proved apart from. */\nexport function unscopedFinding(severity: Severity, brief: Brief, others: string): Finding {\n  return {\n    rule: 'unscoped',\n    severity,\n    message: `declares no affectedFiles, so it cannot be checked against ${others}`,\n    file: brief.file,\n    line: 1,\n    brief: brief.id ?? undefined,\n    hint: 'list the files or globs this round writes under \"affectedFiles\"',\n  };\n}\n"]}

package/dist/config.d.ts

@@ -22,6 +22,13 @@ export interface SectionRule {
     /** The section must hold at least one task item. */
     readonly checklist: boolean;
     readonly optional: boolean;
+    /**
+     * What the section must answer. A new brief carries it as a comment under
+     * the heading, a finding that the section is missing or unwritten carries it
+     * as its hint, and `list` and `lint` report it, so a tool that helps write a
+     * brief can ask for each section without knowing its name in advance.
+     */
+    readonly hint?: string | undefined;
 }
 export interface PluginReference {
     readonly module: string;
@@ -47,6 +54,8 @@ export interface Config {
         readonly field: string | null;
         readonly draft: string | null;
         readonly active: string;
+        /** The word for work put off until an event its `trigger` names; `null` when a repository has none. */
+        readonly deferred: string | null;
         readonly archived: string;
     };
     readonly sections: readonly SectionRule[];
@@ -81,6 +90,8 @@ export declare class ConfigError extends Error {
  * names its own sections means those sections and not the defaults as well.
  */
 export declare function resolveConfig(raw: unknown, file?: string): Config;
+/** The status words a repository uses, in lifecycle order. */
+export declare function statusWords(config: Config): string[];
 /** Parses the text of a configuration file. */
 export declare function parseConfig(text: string, file: string): Config;
 /**

package/dist/config.js

@@ -16,7 +16,7 @@ import { dirname, join } from 'node:path';
 import { parseGlob } from './glob.js';
 import { normalisePath } from './links.js';
 import { toJsonSchema, validate } from './schema.js';
-import { templateHoles } from './text.js';
+import { inWords, templateHoles } from './text.js';
 export const CONFIG_FILES = ['.spec-brief.json', 'spec-brief.json'];
 /** The holes a banner line may use. */
 export const BANNER_PLACEHOLDERS = [
@@ -47,6 +47,11 @@ const SECTION = {
                 mustContain: { ...STRINGS, description: 'Literal text the section must contain.' },
                 checklist: { type: 'boolean', description: 'The section must hold at least one "- [ ]" task item.' },
                 optional: { type: 'boolean', description: 'Checked when present, not required.' },
+                hint: {
+                    type: 'string',
+                    minLength: 1,
+                    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.',
+                },
             },
         },
     ],
@@ -74,6 +79,11 @@ export const CONFIG_SCHEMA = {
                 field: { type: 'string', nullable: true, description: 'Front-matter key holding the status; null uses location only.' },
                 draft: { type: 'string', nullable: true, description: 'The word for a brief still being written, or null.' },
                 active: { type: 'string', minLength: 1, description: 'The word for a live brief.' },
+                deferred: {
+                    type: 'string',
+                    nullable: true,
+                    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.',
+                },
                 archived: { type: 'string', minLength: 1, description: 'The word for an archived brief.' },
             },
         },
@@ -133,19 +143,36 @@ export const DEFAULT_CONFIG = {
     exclude: [],
     template: null,
     id: { source: 'filename', separator: '_', digits: 3 },
-    status: { field: 'status', draft: 'draft', active: 'active', archived: 'archived' },
+    status: { field: 'status', draft: 'draft', active: 'active', deferred: 'deferred', archived: 'archived' },
     sections: [
-        section('Intent', { aliases: ["Commander's Intent", 'Mission', 'Objective'] }),
+        section('Intent', {
+            aliases: ["Commander's Intent", 'Mission', 'Objective'],
+            hint: 'The state of the tree when this round is done, and why it matters. One paragraph.',
+        }),
         section('Negative Scope', {
             aliases: ['Out of Scope', 'Non-Goals', 'Not in Scope', 'What this round is NOT', 'What this brief does NOT do'],
+            hint: 'What this round must not do, even where it would look helpful.',
+        }),
+        section('Not Empowered', {
+            aliases: ['Non-Empowerment', 'Non-Empowerment List'],
+            optional: true,
+            hint: 'Files, interfaces and decisions this round may not change.',
+        }),
+        section('Invariants', {
+            aliases: ['Invariant Checklist', 'Definition of Done'],
+            checklist: true,
+            hint: 'Checks that must hold before the round is called done, each one a task item.',
         }),
-        section('Not Empowered', { aliases: ['Non-Empowerment', 'Non-Empowerment List'], optional: true }),
-        section('Invariants', { aliases: ['Invariant Checklist', 'Definition of Done'], checklist: true }),
     ],
     sectionOrder: false,
     types: {
-        feature: [section('Acceptance Criteria', { checklist: true })],
-        defect: [section('The Defect, Measured', { aliases: ['Reproduction'] })],
+        feature: [section('Acceptance Criteria', { checklist: true, hint: 'What a reviewer checks to accept the result, each one a task item.' })],
+        defect: [
+            section('The Defect, Measured', {
+                aliases: ['Reproduction'],
+                hint: 'How to reproduce the defect, and the measurement that shows it.',
+            }),
+        ],
         refactor: [],
         chore: [],
     },
@@ -178,6 +205,7 @@ function sectionFrom(raw) {
         mustContain: r['mustContain'] ?? [],
         checklist: r['checklist'] ?? false,
         optional: r['optional'] ?? false,
+        hint: r['hint'],
     });
 }
 function pluginFrom(raw) {
@@ -234,6 +262,11 @@ export function resolveConfig(raw, file = 'configuration') {
         throw new ConfigError(file, semantic);
     return config;
 }
+/** The status words a repository uses, in lifecycle order. */
+export function statusWords(config) {
+    const { draft, active, deferred, archived } = config.status;
+    return [draft, active, deferred, archived].filter((w) => w !== null);
+}
 /** What the schema cannot say: relationships between values. */
 function checkConfig(config) {
     const problems = [];
@@ -250,9 +283,22 @@ function checkConfig(config) {
     const archive = inside('archive', config.archive);
     if (briefs !== null && briefs === archive)
         problems.push('"briefs" and "archive" must be different directories');
-    const words = [config.status.draft, config.status.active, config.status.archived].filter((w) => w !== null);
-    if (new Set(words.map((w) => w.toLowerCase())).size !== words.length) {
-        problems.push('the status words for draft, active and archived must differ');
+    // Named by the statuses that share a word: a 0.1 configuration that spelt
+    // another status "deferred" meets the default for the new one here.
+    const sharing = new Map();
+    for (const key of ['draft', 'active', 'deferred', 'archived']) {
+        const word = config.status[key];
+        if (word === null)
+            continue;
+        const group = sharing.get(word.toLowerCase()) ?? { word, keys: [] };
+        group.keys.push(key);
+        sharing.set(word.toLowerCase(), group);
+    }
+    for (const { word, keys } of sharing.values()) {
+        if (keys.length < 2)
+            continue;
+        const orNull = keys.includes('deferred') ? ', or set "status.deferred" to null where no work is deferred' : '';
+        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}`);
     }
     // A pattern that does not parse would match nothing, and a run over no briefs reads as clean.
     for (const [key, pattern] of [['files', config.files], ...config.exclude.map((e) => ['exclude', e])]) {
@@ -331,6 +377,8 @@ export function initialConfig(briefs, archive) {
             out['checklist'] = true;
         if (s.optional)
             out['optional'] = true;
+        if (s.hint !== undefined)
+            out['hint'] = s.hint;
         return Object.keys(out).length === 1 ? s.name : out;
     };
     return {

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 { 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\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    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\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      },\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        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', archived: 'archived' },\n  sections: [\n    section('Intent', { aliases: [\"Commander's Intent\", 'Mission', 'Objective'] }),\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    }),\n    section('Not Empowered', { aliases: ['Non-Empowerment', 'Non-Empowerment List'], optional: true }),\n    section('Invariants', { aliases: ['Invariant Checklist', 'Definition of Done'], checklist: true }),\n  ],\n  sectionOrder: false,\n  types: {\n    feature: [section('Acceptance Criteria', { checklist: true })],\n    defect: [section('The Defect, Measured', { aliases: ['Reproduction'] })],\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  });\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/** 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  const words = [config.status.draft, config.status.active, config.status.archived].filter((w) => w !== null);\n  if (new Set(words.map((w) => w.toLowerCase())).size !== words.length) {\n    problems.push('the status words for draft, active and archived must differ');\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  // Bounded by the depth of the path: each pass moves one directory up.\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    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  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.mustContain.length > 0) out['mustContain'] = s.mustContain;\n    if (s.checklist) out['checklist'] = true;\n    if (s.optional) out['optional'] = true;\n    return Object.keys(out).length === 1 ? s.name : out;\n  };\n  return {\n    $schema: SCHEMA_URL,\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\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/** 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  // Bounded by the depth of the path: each pass moves one directory up.\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    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  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.mustContain.length > 0) out['mustContain'] = s.mustContain;\n    if (s.checklist) out['checklist'] = true;\n    if (s.optional) out['optional'] = true;\n    if (s.hint !== undefined) out['hint'] = s.hint;\n    return Object.keys(out).length === 1 ? s.name : out;\n  };\n  return {\n    $schema: SCHEMA_URL,\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"]}