ddd-ts-kit 0.20.0 → 0.22.0

package/dist/init/write-agent-settings.js.map

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

package/dist/migration/drizzle-kit-bin.d.ts

@@ -0,0 +1,3 @@
+/** The entry file of the drizzle-kit installed in the project, run by the same node: no shell, on every platform. */
+export declare function drizzleKitBin(root: string): string;
+//# sourceMappingURL=drizzle-kit-bin.d.ts.map

package/dist/migration/drizzle-kit-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-kit-bin.d.ts","sourceRoot":"","sources":["../../src/migration/drizzle-kit-bin.ts"],"names":[],"mappings":"AAIA,qHAAqH;AACrH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlD"}

package/dist/migration/drizzle-kit-bin.js

@@ -0,0 +1,12 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { CliError } from '../cli-error.js';
+/** The entry file of the drizzle-kit installed in the project, run by the same node: no shell, on every platform. */
+export function drizzleKitBin(root) {
+    const bin = path.join(root, 'node_modules', 'drizzle-kit', 'bin.cjs');
+    if (!fs.existsSync(bin)) {
+        throw new CliError(`drizzle-kit is not installed in ${root}.`, 'Run `npm install` in the project first.');
+    }
+    return bin;
+}
+//# sourceMappingURL=drizzle-kit-bin.js.map

package/dist/migration/drizzle-kit-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-kit-bin.js","sourceRoot":"","sources":["../../src/migration/drizzle-kit-bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,qHAAqH;AACrH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IAEtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAAC,mCAAmC,IAAI,GAAG,EAAE,yCAAyC,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/migration/drizzle-silent-failures.d.ts

@@ -0,0 +1,9 @@
+/** A failure after which drizzle-kit generate has written nothing and still exits 0, known by what it prints. */
+export interface DrizzleSilentFailure {
+    readonly printed: string;
+    readonly message: string;
+    readonly fix: string;
+}
+/** Measured on drizzle-kit 0.31.11. */
+export declare const DRIZZLE_SILENT_FAILURES: readonly DrizzleSilentFailure[];
+//# sourceMappingURL=drizzle-silent-failures.d.ts.map

package/dist/migration/drizzle-silent-failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-silent-failures.d.ts","sourceRoot":"","sources":["../../src/migration/drizzle-silent-failures.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EAalE,CAAC"}

package/dist/migration/drizzle-silent-failures.js

@@ -0,0 +1,14 @@
+/** Measured on drizzle-kit 0.31.11. */
+export const DRIZZLE_SILENT_FAILURES = [
+    {
+        printed: 'Interactive prompts require a TTY',
+        message: 'drizzle-kit cannot tell whether a column or a table is new or renamed, and asks it on a terminal there is none of: no migration was written.',
+        fix: 'Make the change unambiguous (add the new column or table in one migration, drop the old one in a later one), or write the statements yourself in a custom migration (`npm run db:generate -- <name> --custom`), or run `npm run db:generate <name>` in a terminal and answer. Never give it a pseudo-terminal (`script`, `unbuffer`): it then waits for an answer nobody gives.',
+    },
+    {
+        printed: 'which is a collision',
+        message: 'Two snapshots of the migrations were generated from the same one, as two branches merged without regenerating: no migration was written.',
+        fix: 'Keep the migrations of the main branch, delete the one of your branch (its .sql file, its snapshot under meta/ and its entry of meta/_journal.json), then run `npm run db:generate <name>` again on top of them; `npm run check:arch` names them (persistence/migration-history).',
+    },
+];
+//# sourceMappingURL=drizzle-silent-failures.js.map

package/dist/migration/drizzle-silent-failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-silent-failures.js","sourceRoot":"","sources":["../../src/migration/drizzle-silent-failures.ts"],"names":[],"mappings":"AAOA,uCAAuC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAoC;IACtE;QACE,OAAO,EAAE,mCAAmC;QAC5C,OAAO,EACL,8IAA8I;QAChJ,GAAG,EAAE,iXAAiX;KACvX;IACD;QACE,OAAO,EAAE,sBAAsB;QAC/B,OAAO,EACL,0IAA0I;QAC5I,GAAG,EAAE,mRAAmR;KACzR;CACF,CAAC"}

package/dist/migration/generate-drizzle-migration.d.ts

@@ -0,0 +1,15 @@
+import type { Io } from '../commands/io.js';
+export interface DrizzleMigration {
+    readonly root: string;
+    readonly name: string;
+    readonly custom: boolean;
+    /** True when a person can answer the questions of drizzle-kit: standard input and output are a terminal. */
+    readonly interactive: boolean;
+}
+/**
+ * Runs `drizzle-kit generate` for one named migration and answers its exit code. In a terminal it
+ * is drizzle-kit as is. Without one, a failure after which drizzle-kit writes nothing and exits 0
+ * (its question about a rename, a forked snapshot) becomes an error that names the fix.
+ */
+export declare function generateDrizzleMigration(migration: DrizzleMigration, io: Io): number;
+//# sourceMappingURL=generate-drizzle-migration.d.ts.map

package/dist/migration/generate-drizzle-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-drizzle-migration.d.ts","sourceRoot":"","sources":["../../src/migration/generate-drizzle-migration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAI5C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,4GAA4G;IAC5G,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,CAwBpF"}

package/dist/migration/generate-drizzle-migration.js

@@ -0,0 +1,37 @@
+import { spawnSync } from 'node:child_process';
+import { CliError } from '../cli-error.js';
+import { drizzleKitBin } from './drizzle-kit-bin.js';
+import { DRIZZLE_SILENT_FAILURES } from './drizzle-silent-failures.js';
+/**
+ * Runs `drizzle-kit generate` for one named migration and answers its exit code. In a terminal it
+ * is drizzle-kit as is. Without one, a failure after which drizzle-kit writes nothing and exits 0
+ * (its question about a rename, a forked snapshot) becomes an error that names the fix.
+ */
+export function generateDrizzleMigration(migration, io) {
+    const { root, name, custom, interactive } = migration;
+    const args = [drizzleKitBin(root), 'generate', '--name', name, ...(custom ? ['--custom'] : [])];
+    const run = spawnSync(process.execPath, args, {
+        cwd: root,
+        encoding: 'utf8',
+        stdio: interactive ? 'inherit' : ['ignore', 'pipe', 'pipe'],
+    });
+    if (interactive) {
+        return run.status ?? 1;
+    }
+    printOutput(run.stdout, run.stderr, io);
+    const printed = `${run.stdout}${run.stderr}`;
+    const failure = DRIZZLE_SILENT_FAILURES.find((known) => printed.includes(known.printed));
+    if (failure !== undefined) {
+        throw new CliError(failure.message, failure.fix);
+    }
+    return run.status ?? 1;
+}
+function printOutput(stdout, stderr, io) {
+    if (stdout.trim() !== '') {
+        io.out(stdout.trimEnd());
+    }
+    if (stderr.trim() !== '') {
+        io.err(stderr.trimEnd());
+    }
+}
+//# sourceMappingURL=generate-drizzle-migration.js.map

package/dist/migration/generate-drizzle-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-drizzle-migration.js","sourceRoot":"","sources":["../../src/migration/generate-drizzle-migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAUvE;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAA2B,EAAE,EAAM;IAC1E,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IACtD,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEhG,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;QAC5C,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAC5D,CAAC,CAAC;IAEH,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,MAAc,EAAE,EAAM;IACzD,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzB,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzB,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/migration/index.d.ts

@@ -0,0 +1,2 @@
+export { generateDrizzleMigration } from './generate-drizzle-migration.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/migration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/migration/index.js

@@ -0,0 +1,2 @@
+export { generateDrizzleMigration } from './generate-drizzle-migration.js';
+//# sourceMappingURL=index.js.map

package/dist/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/presets/preset-decision.js

@@ -1,5 +1,5 @@
 import { ADR_DIRECTORY } from '../check/governance/adr-directory.js';
-import { nextAdrNumber } from '../generate/kinds/next-adr-number.js';
+import { adrNumber } from '../generate/kinds/adr-number.js';
 import { vars } from '../generate/vars.js';
 import { renderTemplate } from '../templating/index.js';
 /**
@@ -11,7 +11,7 @@ export function presetDecision(scope, preset) {
     if (scope.config.stack.tenancy === 'none') {
         return '';
     }
-    const number = nextAdrNumber(scope.ws);
+    const number = adrNumber(scope.ws, undefined);
     const adr = { number, date: new Date().toISOString().slice(0, 10) };
     scope.ws.create(`${ADR_DIRECTORY}/${number}-${scope.context.kebab}-is-the-control-plane-of-the-tenants.md`, renderTemplate(`presets/${preset}/decision.md.tpl`, vars(scope, { adr })));
     return `ADR-${number}`;

package/dist/presets/preset-decision.js.map

@@ -1 +1 @@
-{"version":3,"file":"preset-decision.js","sourceRoot":"","sources":["../../src/presets/preset-decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,MAAc;IACzD,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAEpE,KAAK,CAAC,EAAE,CAAC,MAAM,CACb,GAAG,aAAa,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,yCAAyC,EAC1F,cAAc,CAAC,WAAW,MAAM,kBAAkB,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAC1E,CAAC;IAEF,OAAO,OAAO,MAAM,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"preset-decision.js","sourceRoot":"","sources":["../../src/presets/preset-decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,MAAc;IACzD,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAEpE,KAAK,CAAC,EAAE,CAAC,MAAM,CACb,GAAG,aAAa,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,yCAAyC,EAC1F,cAAc,CAAC,WAAW,MAAM,kBAAkB,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAC1E,CAAC;IAEF,OAAO,OAAO,MAAM,EAAE,CAAC;AACzB,CAAC"}

package/dist/progress/read-slice-rules.d.ts

@@ -0,0 +1,8 @@
+import type { Workspace } from '../workspace/index.js';
+/**
+ * The rules written for each row of the slices file, by row id, as the plan-slices skill writes
+ * them under the tables. A row with several lines gets them joined with `; `. Ids are text:
+ * `4.15` and `D4.01` are kept as written.
+ */
+export declare function readSliceRules(ws: Workspace): ReadonlyMap<string, string>;
+//# sourceMappingURL=read-slice-rules.d.ts.map

package/dist/progress/read-slice-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-slice-rules.d.ts","sourceRoot":"","sources":["../../src/progress/read-slice-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMvD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAczE"}

package/dist/progress/read-slice-rules.js

@@ -0,0 +1,20 @@
+import { SLICES_FILE } from './read-slices.js';
+/** A rule line of the slices file: `- #<row>: <invariants and failures by name>`, anywhere outside a table. */
+const RULE_LINE = /^\s*[-*]\s+#([^\s:]+)\s*:\s*(.+?)\s*$/;
+/**
+ * The rules written for each row of the slices file, by row id, as the plan-slices skill writes
+ * them under the tables. A row with several lines gets them joined with `; `. Ids are text:
+ * `4.15` and `D4.01` are kept as written.
+ */
+export function readSliceRules(ws) {
+    const rules = new Map();
+    for (const line of (ws.read(SLICES_FILE) ?? '').split('\n')) {
+        const [, id, text] = RULE_LINE.exec(line) ?? [];
+        if (id !== undefined && text !== undefined) {
+            const present = rules.get(id);
+            rules.set(id, present === undefined ? text : `${present}; ${text}`);
+        }
+    }
+    return rules;
+}
+//# sourceMappingURL=read-slice-rules.js.map

package/dist/progress/read-slice-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-slice-rules.js","sourceRoot":"","sources":["../../src/progress/read-slice-rules.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,+GAA+G;AAC/G,MAAM,SAAS,GAAG,uCAAuC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAa;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAEhD,IAAI,EAAE,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAE9B,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAoD3C,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,GAAE,EAAc,GAAG,MAAM,CAkCvE"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAsD3C,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,GAAE,EAAc,GAAG,MAAM,CAkCvE"}

package/dist/run.js

@@ -6,6 +6,7 @@ import { controllersCommand } from './commands/controllers.js';
 import { depcruiseConfigCommand } from './commands/depcruise-config.js';
 import { describeCommand } from './commands/describe.js';
 import { docsCommand } from './commands/docs.js';
+import { drizzleGenerateCommand } from './commands/drizzle-generate.js';
 import { errorFactoriesCommand } from './commands/error-factories.js';
 import { generateCommand } from './commands/generate.js';
 import { initCommand } from './commands/init.js';
@@ -34,6 +35,7 @@ const COMMANDS = {
     sdk: sdkCommand,
     'depcruise-config': depcruiseConfigCommand,
     'build-aliases': buildAliasesCommand,
+    'drizzle-generate': drizzleGenerateCommand,
     'error-factories': errorFactoriesCommand,
     'value-objects': valueObjectsCommand,
     controllers: controllersCommand,

package/dist/run.js.map

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

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.20.0";
+export declare const VERSION = "0.22.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.20.0';
+export const VERSION = '0.22.0';
 //# sourceMappingURL=version.js.map

package/dist/worker/base-of.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from '../config/index.js';
+/**
+ * The ref a worker's worktree is cut from and checked against: `--base` when given, which must
+ * name a commit, or else the current branch. Without `--base`, refuses to run from the worktree
+ * of a worker: its branch would become the trunk of the new one.
+ */
+export declare function baseOf(root: string, config: Config, base: string | undefined): string;
+//# sourceMappingURL=base-of.d.ts.map

package/dist/worker/base-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-of.d.ts","sourceRoot":"","sources":["../../src/worker/base-of.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAgBrF"}

package/dist/worker/base-of.js

@@ -0,0 +1,36 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { CliError } from '../cli-error.js';
+import { runGit } from '../commit/run-git.js';
+import { WORKER_SCOPE_FILE } from '../commit/worker-scope-file.js';
+/**
+ * The ref a worker's worktree is cut from and checked against: `--base` when given, which must
+ * name a commit, or else the current branch. Without `--base`, refuses to run from the worktree
+ * of a worker: its branch would become the trunk of the new one.
+ */
+export function baseOf(root, config, base) {
+    if (base !== undefined) {
+        return knownRef(root, base);
+    }
+    const current = runGit(root, ['branch', '--show-current'])?.trim() || 'HEAD';
+    const worker = workerBranch(root, config, current);
+    if (worker !== undefined) {
+        throw new CliError(`${root} is the worktree of a worker (${worker}): its branch ${current} would be the trunk of the new worker.`, 'Run worker-scope from the checkout of the trunk, or name the base: `--base origin/main`.');
+    }
+    return current;
+}
+function knownRef(root, base) {
+    if (runGit(root, ['rev-parse', '--verify', '--quiet', `${base}^{commit}`]) === undefined) {
+        throw new CliError(`The base ${base} is not a commit of this repository.`, 'Fetch it first (`git fetch origin`), or pass a branch, a tag or a commit: `--base origin/main`.');
+    }
+    return base;
+}
+/** What makes the current checkout a worker's: its scope file, or a branch named `build/<context>`. */
+function workerBranch(root, config, current) {
+    if (fs.existsSync(path.join(root, WORKER_SCOPE_FILE))) {
+        return `${WORKER_SCOPE_FILE} is present`;
+    }
+    const context = Object.keys(config.contexts).find((name) => current === `build/${name}`);
+    return context === undefined ? undefined : `the branch of the worker of ${context}`;
+}
+//# sourceMappingURL=base-of.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-of.js","sourceRoot":"","sources":["../../src/worker/base-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,MAAc,EAAE,IAAwB;IAC3E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IAC7E,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAChB,GAAG,IAAI,iCAAiC,MAAM,iBAAiB,OAAO,wCAAwC,EAC9G,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAY;IAC1C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,WAAW,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACzF,MAAM,IAAI,QAAQ,CAChB,YAAY,IAAI,sCAAsC,EACtD,iGAAiG,CAClG,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uGAAuG;AACvG,SAAS,YAAY,CAAC,IAAY,EAAE,MAAc,EAAE,OAAe;IACjE,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO,GAAG,iBAAiB,aAAa,CAAC;IAC3C,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,CAAC,CAAC;IAEzF,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,+BAA+B,OAAO,EAAE,CAAC;AACtF,CAAC"}

package/dist/worker/briefed-rows.d.ts

@@ -0,0 +1,14 @@
+import type { Workspace } from '../workspace/index.js';
+import type { BriefedSlice } from './briefed-slice.js';
+/** The rows a worker is briefed on, with their rules, and what the conductor should know about them. */
+export interface BriefedRows {
+    readonly slices: readonly BriefedSlice[];
+    readonly notes: readonly string[];
+}
+/**
+ * The rows of the slices file for one worker: the ids asked for, in the order given, or by
+ * default every row of the context still to do. A row asked for must exist once and belong to
+ * the context. Ids are compared as text.
+ */
+export declare function briefedRows(ws: Workspace, context: string, ids: readonly string[] | undefined): BriefedRows;
+//# sourceMappingURL=briefed-rows.d.ts.map

package/dist/worker/briefed-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefed-rows.d.ts","sourceRoot":"","sources":["../../src/worker/briefed-rows.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wGAAwG;AACxG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAKD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,WAAW,CAO3G"}

package/dist/worker/briefed-rows.js

@@ -0,0 +1,53 @@
+import { CliError } from '../cli-error.js';
+import { readSliceRules } from '../progress/read-slice-rules.js';
+import { readSlices, SLICES_FILE } from '../progress/read-slices.js';
+/** Past this many rows, an agent runs out of turns or context before its report. */
+const ROWS_PER_AGENT = 2;
+/**
+ * The rows of the slices file for one worker: the ids asked for, in the order given, or by
+ * default every row of the context still to do. A row asked for must exist once and belong to
+ * the context. Ids are compared as text.
+ */
+export function briefedRows(ws, context, ids) {
+    const rows = readSlices(ws) ?? [];
+    const rules = readSliceRules(ws);
+    const chosen = ids === undefined ? todoRows(rows, context) : asked(rows, context, ids);
+    const slices = chosen.map((row) => ({ ...row, rules: rules.get(row.id) }));
+    return { slices, notes: [...doneNotes(slices, ids), ...sizeNotes(slices, context)] };
+}
+function todoRows(rows, context) {
+    return rows.filter((row) => row.owner === context && row.status === 'todo');
+}
+function asked(rows, context, ids) {
+    return ids.map((id) => {
+        const matching = rows.filter((row) => row.id === id);
+        const [row] = matching;
+        if (row === undefined) {
+            throw new CliError(`Row #${id} is not in ${SLICES_FILE}.`, `Pass the ids of the # column as written (\`--rows 4.15,4.16\`); \`npx ddd-ts-kit status\` lists them.`);
+        }
+        if (matching.length > 1) {
+            throw new CliError(`Row #${id} appears ${matching.length} times in ${SLICES_FILE}.`, 'Number every row once across the file (`npx ddd-ts-kit status` names the numbers used twice), then brief again.');
+        }
+        if (row.owner !== context) {
+            throw new CliError(`Row #${id} is owned by ${row.owner || 'nobody'}, not by ${context}.`, `Brief that row to the worker of its owner, or change its Owner column to ${context} first.`);
+        }
+        return row;
+    });
+}
+function doneNotes(slices, ids) {
+    if (ids === undefined) {
+        return [];
+    }
+    return slices
+        .filter((row) => row.status === 'done')
+        .map((row) => `Row #${row.id} is marked done in ${SLICES_FILE}: brief it again only to rework it.`);
+}
+function sizeNotes(slices, context) {
+    if (slices.length <= ROWS_PER_AGENT) {
+        return [];
+    }
+    return [
+        `${slices.length} rows in one briefing: an agent holds ${ROWS_PER_AGENT} at most before its turns or its context run out. Brief one agent per row, in sequence, with \`npx ddd-ts-kit worker-scope ${context} --rows <id>\`.`,
+    ];
+}
+//# sourceMappingURL=briefed-rows.js.map

package/dist/worker/briefed-rows.js.map

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

package/dist/worker/briefed-slice.d.ts

@@ -0,0 +1,7 @@
+import type { Slice } from '../progress/slice.js';
+/** A row of the slices table as a worker is briefed on it: with the rules written for it under the tables. */
+export interface BriefedSlice extends Slice {
+    /** The invariants and the failures by name, from the line `- #<row>: ...` of the slices file; undefined when none. */
+    readonly rules: string | undefined;
+}
+//# sourceMappingURL=briefed-slice.d.ts.map

package/dist/worker/briefed-slice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefed-slice.d.ts","sourceRoot":"","sources":["../../src/worker/briefed-slice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,8GAA8G;AAC9G,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC,sHAAsH;IACtH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC"}

package/dist/worker/briefed-slice.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=briefed-slice.js.map

package/dist/worker/briefed-slice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefed-slice.js","sourceRoot":"","sources":["../../src/worker/briefed-slice.ts"],"names":[],"mappings":""}

package/dist/worker/briefing-of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"briefing-of.d.ts","sourceRoot":"","sources":["../../src/worker/briefing-of.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA+BrD"}
+{"version":3,"file":"briefing-of.d.ts","sourceRoot":"","sources":["../../src/worker/briefing-of.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAkCrD"}

package/dist/worker/briefing-of.js

@@ -1,3 +1,5 @@
+/** The report a worker keeps current in its worktree, ignored by git with the rest of `.ddd-ts-kit/`. */
+const REPORT_FILE = '.ddd-ts-kit/report.md';
 /**
  * The briefing of a context worker, as the parallel-work skill of the plugin writes it, with
  * what the project says filled in. What only the conductor knows stays between angle brackets.
@@ -22,15 +24,18 @@ export function briefingOf(place) {
         `\`npx ddd-ts-kit describe ${context} --json\`. Then the \`next\` places each generator prints.`,
         '',
         'For each slice: generate with --local-only --json, fill the TODO(domain) markers, replace every it.todo',
-        `by a test, \`npx ddd-ts-kit check --changed-since ${trunk}\`, \`npm test -- ${context}\`, then one`,
-        `commit: \`feat(${context}): <slice in business words>\`.`,
+        `by a test, \`npm run regenerate\`, \`npx ddd-ts-kit check --changed-since ${trunk}\`, \`npm test -- ${context}\`,`,
+        `then one commit, with the files regenerate rewrote: \`feat(${context}): <slice in business words>\`.`,
+        `After each step, rewrite ${REPORT_FILE} in the worktree in the form of the report below: if you stop,`,
+        'the conductor reads it there.',
         '',
         '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 +44,9 @@ 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>`. The derived files (generated',
+        '  documents, barrels, context map, dependency rules) are written by `npm run regenerate`, never by hand.',
         `- Generators you may run: ${generators.join(', ')}.`,
         '  The others are run by the conductor.',
     ];
@@ -48,7 +55,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,yGAAyG;AACzG,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAE5C;;;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,6EAA6E,KAAK,qBAAqB,OAAO,KAAK;QACnH,8DAA8D,OAAO,iCAAiC;QACtG,4BAA4B,WAAW,gEAAgE;QACvG,+BAA+B;QAC/B,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,sGAAsG;QACtG,0GAA0G;QAC1G,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"}