ddd-ts-kit 0.19.0 → 0.21.0

package/dist/worker/briefing-of.js

@@ -28,9 +28,10 @@ export function briefingOf(place) {
         'Done when: every slice is committed, `npm run verify` is green in the worktree, and',
         `\`npx ddd-ts-kit todo ${context}\` lists nothing.`,
         '',
-        'Report, in under 200 words: slices done (commit hashes), slices not done and why, needs on',
-        "shared files or on another context's contract, glossary terms added, open business",
-        'questions. No code, no file contents.',
+        'Report, always, even when you stop early, in under 200 words: slices done (commit hashes),',
+        'slices not done and why, with the files left modified by an unfinished one, needs on shared',
+        "files or on another context's contract, glossary terms added, open business questions. No",
+        'code, no file contents.',
     ].join('\n');
 }
 function scopeLines({ config, generators }, directory) {
@@ -39,7 +40,8 @@ function scopeLines({ config, generators }, directory) {
         `- You may write: ${directory}/** and test/e2e/<use-case>.e2e.spec.ts of your slices.`,
         `- You may not write anything else. Shared files (config, ${config.platformDir}, ${config.sourceRoot}/main.ts,`,
         '  package.json, lockfile, migrations, docs/) and other contexts are refused by the guard:',
-        '  report the need, do not work around it.',
+        '  report the need, do not work around it. A slice that changes the stored state generates a',
+        '  working migration only: `npm run db:generate working-<what-it-does>`.',
         `- Generators you may run: ${generators.join(', ')}.`,
         '  The others are run by the conductor.',
     ];
@@ -48,7 +50,7 @@ function sliceLines(slices) {
     if (slices.length === 0) {
         return ['- #<n> <slice>: <generator commands of the row> ; rules: <invariants and failures by name>'];
     }
-    return slices.map((row) => `- #${row.id} ${row.slice}: ${row.startWith} ; rules: <invariants and failures by name>`);
+    return slices.map((row) => `- #${row.id} ${row.slice}: ${row.startWith}${row.rules === undefined ? '' : ` ; rules: ${row.rules}`}`);
 }
 function contractsOf({ config, context }) {
     const upstreams = config.contexts[context]?.upstreams ?? [];

package/dist/worker/briefing-of.js.map

@@ -1 +1 @@
-{"version":3,"file":"briefing-of.js","sourceRoot":"","sources":["../../src/worker/briefing-of.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,SAAS,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,EAAE,CAAC;IAE3D,OAAO;QACL,iCAAiC,OAAO,OAAO,KAAK,CAAC,OAAO,GAAG;QAC/D,EAAE;QACF,aAAa,IAAI,cAAc,KAAK,CAAC,MAAM,aAAa,KAAK,EAAE;QAC/D,6CAA6C,IAAI,wBAAwB,IAAI,MAAM;QACnF,EAAE;QACF,GAAG,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC;QAC/B,EAAE;QACF,6DAA6D;QAC7D,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;QAC3B,EAAE;QACF,sCAAsC,WAAW,CAAC,KAAK,CAAC,EAAE;QAC1D,EAAE;QACF,yBAAyB,SAAS,mBAAmB;QACrD,6BAA6B,OAAO,4DAA4D;QAChG,EAAE;QACF,yGAAyG;QACzG,qDAAqD,KAAK,qBAAqB,OAAO,cAAc;QACpG,kBAAkB,OAAO,iCAAiC;QAC1D,EAAE;QACF,qFAAqF;QACrF,yBAAyB,OAAO,mBAAmB;QACnD,EAAE;QACF,4FAA4F;QAC5F,oFAAoF;QACpF,uCAAuC;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAe,EAAE,SAAiB;IACxE,OAAO;QACL,OAAO;QACP,oBAAoB,SAAS,yDAAyD;QACtF,4DAA4D,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,UAAU,WAAW;QAC/G,2FAA2F;QAC3F,2CAA2C;QAC3C,6BAA6B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACrD,wCAAwC;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAAwB;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,4FAA4F,CAAC,CAAC;IACxG,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,SAAS,6CAA6C,CAAC,CAAC;AACvH,CAAC;AAED,SAAS,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAe;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IAE5D,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC;QACzB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,sBAAsB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACzG,CAAC,CAAC,MAAM,CAAC;AACb,CAAC"}
+{"version":3,"file":"briefing-of.js","sourceRoot":"","sources":["../../src/worker/briefing-of.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,SAAS,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,EAAE,CAAC;IAE3D,OAAO;QACL,iCAAiC,OAAO,OAAO,KAAK,CAAC,OAAO,GAAG;QAC/D,EAAE;QACF,aAAa,IAAI,cAAc,KAAK,CAAC,MAAM,aAAa,KAAK,EAAE;QAC/D,6CAA6C,IAAI,wBAAwB,IAAI,MAAM;QACnF,EAAE;QACF,GAAG,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC;QAC/B,EAAE;QACF,6DAA6D;QAC7D,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;QAC3B,EAAE;QACF,sCAAsC,WAAW,CAAC,KAAK,CAAC,EAAE;QAC1D,EAAE;QACF,yBAAyB,SAAS,mBAAmB;QACrD,6BAA6B,OAAO,4DAA4D;QAChG,EAAE;QACF,yGAAyG;QACzG,qDAAqD,KAAK,qBAAqB,OAAO,cAAc;QACpG,kBAAkB,OAAO,iCAAiC;QAC1D,EAAE;QACF,qFAAqF;QACrF,yBAAyB,OAAO,mBAAmB;QACnD,EAAE;QACF,4FAA4F;QAC5F,6FAA6F;QAC7F,2FAA2F;QAC3F,yBAAyB;KAC1B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAe,EAAE,SAAiB;IACxE,OAAO;QACL,OAAO;QACP,oBAAoB,SAAS,yDAAyD;QACtF,4DAA4D,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,UAAU,WAAW;QAC/G,2FAA2F;QAC3F,6FAA6F;QAC7F,yEAAyE;QACzE,6BAA6B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACrD,wCAAwC;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAA+B;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,4FAA4F,CAAC,CAAC;IACxG,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CACf,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,KAAK,EAAE,EAAE,CACjH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAe;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IAE5D,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC;QACzB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,sBAAsB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACzG,CAAC,CAAC,MAAM,CAAC;AACb,CAAC"}

package/dist/worker/ensure-contains-base.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Refuses a branch that does not contain the base: a worker on it would build on a stale
+ * trunk, and its merge would undo what the trunk gained since.
+ */
+export declare function ensureContainsBase(root: string, branch: string, base: string): void;
+//# sourceMappingURL=ensure-contains-base.d.ts.map

package/dist/worker/ensure-contains-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-contains-base.d.ts","sourceRoot":"","sources":["../../src/worker/ensure-contains-base.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CASnF"}

package/dist/worker/ensure-contains-base.js

@@ -0,0 +1,13 @@
+import { CliError } from '../cli-error.js';
+import { runGit } from '../commit/run-git.js';
+/**
+ * Refuses a branch that does not contain the base: a worker on it would build on a stale
+ * trunk, and its merge would undo what the trunk gained since.
+ */
+export function ensureContainsBase(root, branch, base) {
+    if (runGit(root, ['merge-base', '--is-ancestor', base, branch]) !== undefined) {
+        return;
+    }
+    throw new CliError(`The branch ${branch} does not contain ${base}: its worker would build on a stale base.`, `Bring it up to date first (\`git -C <worktree> merge ${base}\`, or rebase it), or pass the base it was cut from with --base <ref>.`);
+}
+//# sourceMappingURL=ensure-contains-base.js.map

package/dist/worker/ensure-contains-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-contains-base.js","sourceRoot":"","sources":["../../src/worker/ensure-contains-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY;IAC3E,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9E,OAAO;IACT,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,cAAc,MAAM,qBAAqB,IAAI,2CAA2C,EACxF,wDAAwD,IAAI,wEAAwE,CACrI,CAAC;AACJ,CAAC"}

package/dist/worker/open-worker-scope.d.ts

@@ -7,12 +7,16 @@ export interface WorkerRequest {
     readonly worktree?: string;
     /** By default `build/<context>`. */
     readonly branch?: string;
+    /** The ref the worktree is cut from and checked against; by default the current branch. */
+    readonly base?: string;
+    /** The ids of the rows to brief, in this order; by default every row of the context still to do. */
+    readonly rows?: readonly string[];
     readonly dryRun: boolean;
 }
 /**
- * Gives one worker its place: a git worktree of the project on its own branch, the file that
- * confines it to its context, and its briefing. An existing worktree is kept: only the file is
- * written again.
+ * Gives one worker its place: a git worktree of the project on its own branch, cut from the
+ * base, the file that confines it to its context, and its briefing. An existing worktree or
+ * branch is kept when it contains the base: only the file is written again.
  */
 export declare function openWorkerScope(root: string, config: Config, request: WorkerRequest): WorkerScope;
 //# sourceMappingURL=open-worker-scope.d.ts.map

package/dist/worker/open-worker-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-worker-scope.d.ts","sourceRoot":"","sources":["../../src/worker/open-worker-scope.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAMjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iGAAiG;IACjG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,CA+BjG"}
+{"version":3,"file":"open-worker-scope.d.ts","sourceRoot":"","sources":["../../src/worker/open-worker-scope.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAOjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iGAAiG;IACjG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oGAAoG;IACpG,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,CA+BjG"}

package/dist/worker/open-worker-scope.js

@@ -4,25 +4,27 @@ import { CliError } from '../cli-error.js';
 import { runGit } from '../commit/run-git.js';
 import { WORKER_SCOPE_FILE } from '../commit/worker-scope-file.js';
 import { KINDS } from '../generate/kinds.js';
-import { readSlices } from '../progress/read-slices.js';
 import { Workspace } from '../workspace/index.js';
+import { briefedRows } from './briefed-rows.js';
 import { briefingOf } from './briefing-of.js';
+import { ensureContainsBase } from './ensure-contains-base.js';
+import { baseOf } from './base-of.js';
 import { workerGenerators } from './worker-generators.js';
 /**
- * Gives one worker its place: a git worktree of the project on its own branch, the file that
- * confines it to its context, and its briefing. An existing worktree is kept: only the file is
- * written again.
+ * Gives one worker its place: a git worktree of the project on its own branch, cut from the
+ * base, the file that confines it to its context, and its briefing. An existing worktree or
+ * branch is kept when it contains the base: only the file is written again.
  */
 export function openWorkerScope(root, config, request) {
     const { context, dryRun } = request;
-    const { project, worktree, branch, trunk, created, inside } = placeOf(root, request);
+    const { project, worktree, branch, trunk, created, inside } = placeOf(root, config, request);
+    const { slices, notes } = briefedRows(new Workspace(root, false), context, request.rows);
     if (created && !dryRun) {
-        addWorktree(root, worktree, branch);
+        addWorktree(root, { worktree, branch, base: trunk });
     }
     if (!dryRun) {
         writeScope(inside, context);
     }
-    const slices = todoSlices(root, context);
     const generators = workerGenerators(KINDS);
     const briefing = briefingOf({ config, context, project, root: inside, branch, trunk, generators, slices });
     return {
@@ -38,25 +40,33 @@ export function openWorkerScope(root, config, request) {
         generators,
         slices,
         briefing,
-        notes: notesOf(root, dryRun ? root : inside),
+        notes: [...notes, ...notesOf(root, dryRun ? root : inside)],
     };
 }
-function placeOf(root, request) {
-    const repository = repositoryOf(root);
+function placeOf(root, config, request) {
+    const prefix = prefixOf(root);
+    const trunk = baseOf(root, config, request.base);
     const project = path.basename(root);
     const worktree = path.resolve(root, request.worktree ?? `../${project}-${request.context}`);
     const branch = request.branch ?? `build/${request.context}`;
     const created = !isWorktree(root, worktree);
+    if (!created) {
+        ensureContainsBase(worktree, runGit(worktree, ['branch', '--show-current'])?.trim() || 'HEAD', trunk);
+    }
+    else if (branchExists(root, branch)) {
+        ensureContainsBase(root, branch, trunk);
+    }
     return {
         project,
         worktree,
         branch,
-        trunk: repository.trunk,
+        trunk,
         created,
-        inside: path.join(worktree, repository.prefix),
+        inside: path.join(worktree, prefix),
     };
 }
-function repositoryOf(root) {
+/** The path of the project inside its repository, empty at its top. */
+function prefixOf(root) {
     const prefix = runGit(root, ['rev-parse', '--show-prefix']);
     if (prefix === undefined) {
         throw new CliError(`${root} is not inside a git repository.`, 'Run `git init` and make a first commit: a worktree is cut from a commit.');
@@ -64,7 +74,7 @@ function repositoryOf(root) {
     if (runGit(root, ['rev-parse', '--verify', '--quiet', 'HEAD']) === undefined) {
         throw new CliError('The repository has no commit yet.', 'Commit the bootstrap first: a worktree is cut from a commit.');
     }
-    return { trunk: runGit(root, ['branch', '--show-current'])?.trim() || 'HEAD', prefix: prefix.trim() };
+    return prefix.trim();
 }
 function isWorktree(root, worktree) {
     if (!fs.existsSync(worktree)) {
@@ -79,11 +89,16 @@ function isWorktree(root, worktree) {
     }
     throw new CliError(`${worktree} exists and is not a worktree of this repository.`, 'Pass another directory with --worktree <path>, or remove that one.');
 }
-function addWorktree(root, worktree, branch) {
-    const exists = runGit(root, ['rev-parse', '--verify', '--quiet', `refs/heads/${branch}`]) !== undefined;
-    const added = runGit(root, ['worktree', 'add', worktree, ...(exists ? [branch] : ['-b', branch])]);
+function branchExists(root, branch) {
+    return runGit(root, ['rev-parse', '--verify', '--quiet', `refs/heads/${branch}`]) !== undefined;
+}
+/** Adds the worktree on its branch: an existing branch is checked out, a new one is cut from the base. */
+function addWorktree(root, place) {
+    const { worktree, branch, base } = place;
+    const target = branchExists(root, branch) ? [branch] : ['-b', branch, base];
+    const added = runGit(root, ['worktree', 'add', worktree, ...target]);
     if (added === undefined) {
-        throw new CliError(`git could not add the worktree ${worktree} on the branch ${branch}.`, `Run \`git worktree add ${worktree} ${exists ? branch : `-b ${branch}`}\` to read its reason; a branch checked out elsewhere takes --branch <name>.`);
+        throw new CliError(`git could not add the worktree ${worktree} on the branch ${branch}.`, `Run \`git worktree add ${worktree} ${target.join(' ')}\` to read its reason; a branch checked out elsewhere takes --branch <name>.`);
     }
 }
 function writeScope(inside, context) {
@@ -91,9 +106,6 @@ function writeScope(inside, context) {
     fs.mkdirSync(path.dirname(file), { recursive: true });
     fs.writeFileSync(file, `${JSON.stringify({ context }, null, 2)}\n`);
 }
-function todoSlices(root, context) {
-    return (readSlices(new Workspace(root, false)) ?? []).filter((row) => row.owner === context && row.status === 'todo');
-}
 function notesOf(root, inside) {
     const ignored = runGit(inside, ['check-ignore', '--quiet', WORKER_SCOPE_FILE]) !== undefined;
     const installed = fs.existsSync(path.join(inside, 'node_modules')) || inside === root;

package/dist/worker/open-worker-scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"open-worker-scope.js","sourceRoot":"","sources":["../../src/worker/open-worker-scope.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"open-worker-scope.js","sourceRoot":"","sources":["../../src/worker/open-worker-scope.ts"],"names":[],"mappings":"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"}

package/dist/worker/worker-place.d.ts

@@ -1,5 +1,5 @@
 import type { Config } from '../config/index.js';
-import type { Slice } from '../progress/slice.js';
+import type { BriefedSlice } from './briefed-slice.js';
 /** What a briefing is filled with. */
 export interface WorkerPlace {
     readonly config: Config;
@@ -10,6 +10,6 @@ export interface WorkerPlace {
     readonly branch: string;
     readonly trunk: string;
     readonly generators: readonly string[];
-    readonly slices: readonly Slice[];
+    readonly slices: readonly BriefedSlice[];
 }
 //# sourceMappingURL=worker-place.d.ts.map

package/dist/worker/worker-place.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-place.d.ts","sourceRoot":"","sources":["../../src/worker/worker-place.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CACnC"}
+{"version":3,"file":"worker-place.d.ts","sourceRoot":"","sources":["../../src/worker/worker-place.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C"}

package/dist/worker/worker-scope.d.ts

@@ -1,4 +1,4 @@
-import type { Slice } from '../progress/slice.js';
+import type { BriefedSlice } from './briefed-slice.js';
 /** The place one worker builds one context in, and what to tell that worker. */
 export interface WorkerScope {
     readonly dryRun: boolean;
@@ -10,7 +10,7 @@ export interface WorkerScope {
     /** Absolute path of the project inside the worktree: where every command of the worker runs. */
     readonly root: string;
     readonly branch: string;
-    /** The branch the worktree was cut from, and that the worker merges back from. */
+    /** The base: the ref the worktree was cut from (`--base`, by default the current branch), that the worker checks against and merges back from. */
     readonly trunk: string;
     /** True when this run created the worktree, or would with `--dry-run`. */
     readonly created: boolean;
@@ -18,8 +18,8 @@ export interface WorkerScope {
     readonly scopeFile: string;
     /** The generator kinds the worker may run; the conductor runs the others on the trunk. */
     readonly generators: readonly string[];
-    /** The rows of the slices table owned by the context and still to do. */
-    readonly slices: readonly Slice[];
+    /** The rows of the slices table the worker builds: those of `--rows`, by default those of the context still to do. */
+    readonly slices: readonly BriefedSlice[];
     readonly briefing: string;
     readonly notes: readonly string[];
 }

package/dist/worker/worker-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-scope.d.ts","sourceRoot":"","sources":["../../src/worker/worker-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC"}
+{"version":3,"file":"worker-scope.d.ts","sourceRoot":"","sources":["../../src/worker/worker-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kJAAkJ;IAClJ,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,sHAAsH;IACtH,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ddd-ts-kit",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "Bootstrap, scaffold and verify Domain-Driven Design (DDD), Clean Architecture and hexagonal TypeScript backends on Node.js: project and code generators, architecture checks, OpenAPI and AsyncAPI documents, for developers and AI coding agents (Claude Code, Codex, GitHub Copilot).",
   "keywords": [
     "ddd",
@@ -29,7 +29,7 @@
     "url": "git+https://github.com/gbourgeat/ddd-ts-kit.git",
     "directory": "packages/cli"
   },
-  "homepage": "https://github.com/gbourgeat/ddd-ts-kit/tree/main/packages/cli#readme",
+  "homepage": "https://gbourgeat.github.io/ddd-ts-kit/",
   "bugs": "https://github.com/gbourgeat/ddd-ts-kit/issues",
   "publishConfig": {
     "access": "public",
@@ -52,6 +52,6 @@
     "clean:packages": "node dist/bin.js check --clean-only ../kernel/src ../validation/src ../http/src ../tracing/src ../di/src ../events/src ../testing/src ../s3/src ../drizzle/src ../knex/src ../prisma/src ../typeorm/src ../aspects/src ../rabbitmq/src ../auth/src ../audit/src ../redis/src ../scheduling/src ../pino/src ../winston/src ../sentry/src ../kafka/src ../nats/src ../eslint-plugin/src"
   },
   "devDependencies": {
-    "@ddd-ts-kit/kernel": "^0.19.0"
+    "@ddd-ts-kit/kernel": "^0.21.0"
   }
 }

package/templates/init/AGENTS.md.tpl

@@ -8,7 +8,7 @@ A ddd-ts-kit project: one bounded context per directory of `{{config.contextsDir
 - `npx ddd-ts-kit check --changed-since <ref>`: the architecture rules on what changed; `npx ddd-ts-kit explain <rule-id>` gives the reason and an example.
 - `npx ddd-ts-kit list --json`: the map of the contexts. `npx ddd-ts-kit describe <context> --json`: one context as data (use cases, routes, events, ports, dependencies).
 - `npx ddd-ts-kit status`: the next step of the plan, the slices by status, the markers left per context. `npx ddd-ts-kit todo [<context>]`: each remaining `TODO(domain)` and `it.todo` as `file:line`.
-- `npx ddd-ts-kit docs`: regenerates the context map and the generated sections of each `CONTEXT.md`; `npm run docs:generate` the OpenAPI contract, the forms and the event catalog.
+- `npm run regenerate`: every derived file in one step, after a change of route, schema, event or config: `.dependency-cruiser.cjs`, then `npm run docs:generate`, which runs `npx ddd-ts-kit docs` (the context map, the barrels, the generated sections of each `CONTEXT.md`) and writes the OpenAPI contract, the forms and the event catalog.
 
 ## Read less
 
@@ -29,7 +29,7 @@ Never edit `<context>.declarations.ts`: `generate`, `docs` and `npm run dev` rew
 {{#if assembly.discovery}}
 Never edit `<context>.dependencies.ts`: `generate`, `docs` and `npm run dev` rewrite it from the constructor signatures (it registers what each constructor is injected). After changing a constructor by hand, `npx ddd-ts-kit docs`.
 {{/if}}
-Never edit the contracts under `openapi/` (`openapi/openapi.yaml`, one file per document when `openapi.documents` splits it, the forms of `openapi/forms/`), `docs/integration/asyncapi.yaml`, `docs/integration/event-catalog.md`, `{{config.platformDir}}/http/openapi-documents.ts`, `.dependency-cruiser.cjs` or the generated sections of a `CONTEXT.md`: change the code or the config, then `npm run docs:generate`, `npx ddd-ts-kit docs` and `npx ddd-ts-kit depcruise-config --write`. `stored-events.lock.json` is written by `npx ddd-ts-kit docs --stored-events` once the shape of a version is final (`docs --check` fails while one is unrecorded), never by hand: a stored shape changes only by a new version with its upcaster (`event-sourcing/upcaster-required`).
+Never edit the contracts under `openapi/` (`openapi/openapi.yaml`, one file per document when `openapi.documents` splits it, the forms of `openapi/forms/`), `docs/integration/asyncapi.yaml`, `docs/integration/event-catalog.md`, `{{config.platformDir}}/http/openapi-documents.ts`, `.dependency-cruiser.cjs` or the generated sections of a `CONTEXT.md`: change the code or the config, then `npm run regenerate`. `stored-events.lock.json` is written by `npx ddd-ts-kit docs --stored-events` once the shape of a version is final (`docs --check` fails while one is unrecorded), never by hand: a stored shape changes only by a new version with its upcaster (`event-sourcing/upcaster-required`).
 {{#if sdk.on}}
 {{sdk.instruction}}
 {{/if}}

package/templates/init/README.md.tpl

@@ -320,4 +320,5 @@ for each moment of the project: https://github.com/gbourgeat/ddd-ts-kit/blob/mai
 | `npm run test:e2e` | the whole application through HTTP, on an in-process database unless `DATABASE_URL` is set |
 | `npm run check:arch` | `ddd-ts-kit check` |
 | `npm run docs:generate` | context map, OpenAPI, AsyncAPI and event catalog{{#if sdk.on}}, the clients under `clients/`{{/if}} |
+| `npm run regenerate` | every derived file after a change: `.dependency-cruiser.cjs`, then `docs:generate` |
 | `npm run verify` | everything CI runs |

package/templates/init/rules/application.md.tpl

@@ -10,12 +10,12 @@ paths:
 - Events leave with the save: never `pullEvents()`, never a `DomainEventDispatcher` here (`domain-events/dispatched-on-save`). A reaction is a class of `event-handlers/` or a publisher of `integration/publishers/`. It runs at the end of the unit of work, before the commit, and depends only on what the transaction covers (`domain-events/transactional-before-commit`): repositories, the integration event publisher, the command bus. An effect outside the database is a handler of the `after-commit` phase (`generate event-handler ... --phase after-commit`: at most once, never saves, sends a command) or, when it must not be lost, the handler of an integration event.
 - Nothing here reads the event store: an event-sourced aggregate is loaded and saved through its repository port like any other (`event-sourcing/store-behind-repository`). A projection writes its read model and never a stream (`event-sourcing/projection-never-appends`); one fed by the store is declared `@Projection(name, { feed: 'event-store' })`.
 {{#if style.declared}}
-- Every command and query carries `@Requires(permission)` or `@Public()` (`authz/declared`), and the actor is in the message (`authz/actor-explicit`). Permissions live in `authorization/<context>.permissions.ts`, rules that need loaded state in `authorization/*.policy.ts`.
+- Every command and query carries `@Requires(permission)` or `@Public()` (`authz/declared`), and the actor is in the message (`authz/actor-explicit`). Permissions live in `authorization/<context>.permissions.ts`, rules that need loaded state in `authorization/*.policy.ts`.{{#if authz.rbac}} A role holds each permission by name in the roles of the platform (`--grant <role>` when generating it): the super-admin `*` alone refuses everybody else (`authz/granted`).{{/if}}
 - The decorator is the registration (`declarations/role-declared`): `@CommandHandler(Message)`, `@QueryHandler(Message)`, `@DomainEventHandler(Event)` (the name is the static `eventName` of the event class), `@IntegrationEventHandler(definition, { consumer })`, `@Scheduled('<context>.<job>', schedule)`, `@Background(options)` (the name is the static `jobName`), `@Projection('<context>.<name>')`, `@Policy(permission, { name })`. Names are string literals.
 - The constructor is the one statement of what a class depends on (`declarations/constructor-injection`): each parameter is typed by one port class, with no `?`, default value, rest or destructuring, and no list repeats it in the decorator. To add a dependency, add the parameter: `npx ddd-ts-kit docs` reads the signature into the generated file of the context (`npm run dev` does it on every change), never edit that file.
 {{/if}}
 {{#if style.explicit}}
-- Every command and query is registered in `<context>.module.ts` with the permission it requires, or as public (`authz/declared`), and the actor is in the message (`authz/actor-explicit`). Permissions live in `authorization/<context>.permissions.ts`, rules that need loaded state in `authorization/*.policy.ts`.
+- Every command and query is registered in `<context>.module.ts` with the permission it requires, or as public (`authz/declared`), and the actor is in the message (`authz/actor-explicit`). Permissions live in `authorization/<context>.permissions.ts`, rules that need loaded state in `authorization/*.policy.ts`.{{#if authz.rbac}} A role holds each permission by name in the roles of the platform (`--grant <role>` when generating it): the super-admin `*` alone refuses everybody else (`authz/granted`).{{/if}}
 - A class here carries no registration of its own: `<context>.module.ts` binds it and lists what its constructor receives. A job is registered as `@Scheduled('<context>.<job>', schedule)` would say: one name, one schedule, and the command bus as its only dependency.
 {{/if}}
 - A port is an abstract class in `ports/<name>.port.ts` and its own injection token (`ports/abstract-class`, `ports/no-token-constant`), named for the need (`PaymentGateway`), with a fake in `test/fakes/`.

package/templates/pipeline/package-scripts.json

@@ -23,7 +23,7 @@
     "@biomejs/biome": "2.5.15",
     "@commitlint/cli": "^21.2.3",
     "@commitlint/config-conventional": "^21.2.3",
-    "@ddd-ts-kit/eslint-plugin": "^0.19.0",
+    "@ddd-ts-kit/eslint-plugin": "^0.21.0",
     "@eslint/js": "^10.0.1",
     "@typescript/native": "npm:typescript@~7.0.2",
     "@vitest/coverage-v8": "5.0.3",

package/templates/pipeline/vitest.config.ts.tpl

@@ -39,7 +39,16 @@ export default defineConfig(({ mode }) => ({
           exclude: [INTEGRATION_SPECS, ...NOT_AFFECTED],
         },
       },
-      { extends: true, test: { name: INTEGRATION_MODE, include: [INTEGRATION_SPECS], exclude: NOT_AFFECTED } },
+      {
+        extends: true,
+        test: {
+          name: INTEGRATION_MODE,
+          include: [INTEGRATION_SPECS],
+          exclude: NOT_AFFECTED,
+          // A hook opens the test database (PGlite started and its tables created, or a server reached): under coverage on a busy machine it outlasts the default 10 seconds.
+          hookTimeout: 60_000,
+        },
+      },
     ],
     coverage: {
       provider: 'v8',

package/dist/generate/kinds/next-adr-number.d.ts

@@ -1,4 +0,0 @@
-import type { Workspace } from '../../workspace/index.js';
-/** The number the next decision record of the project takes: one after the highest in `docs/adr/`. */
-export declare function nextAdrNumber(ws: Workspace): string;
-//# sourceMappingURL=next-adr-number.d.ts.map

package/dist/generate/kinds/next-adr-number.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"next-adr-number.d.ts","sourceRoot":"","sources":["../../../src/generate/kinds/next-adr-number.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAInD"}

package/dist/generate/kinds/next-adr-number.js

@@ -1,7 +0,0 @@
-import { ADR_DIRECTORY } from '../../check/governance/adr-directory.js';
-/** The number the next decision record of the project takes: one after the highest in `docs/adr/`. */
-export function nextAdrNumber(ws) {
-    const taken = ws.list(ADR_DIRECTORY).map((file) => Number(/^(\d+)-/.exec(file)?.[1] ?? '0'));
-    return String(Math.max(0, ...taken) + 1).padStart(4, '0');
-}
-//# sourceMappingURL=next-adr-number.js.map

package/dist/generate/kinds/next-adr-number.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"next-adr-number.js","sourceRoot":"","sources":["../../../src/generate/kinds/next-adr-number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGxE,sGAAsG;AACtG,MAAM,UAAU,aAAa,CAAC,EAAa;IACzC,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAE7F,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC"}