ddd-ts-kit 0.16.1 → 0.18.0

package/dist/markers/index.js

@@ -1,4 +1,5 @@
 export { insertInRegion } from './insert-in-region.js';
 export { parseWiring } from './parse-wiring.js';
+export { replaceInRegion } from './replace-in-region.js';
 export { replaceRegion } from './replace-region.js';
 //# sourceMappingURL=index.js.map

package/dist/markers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/markers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/markers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/markers/replace-in-region.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Replaces, inside a region, the lines a block was added as by the lines another block is added
+ * as, both laid out for the indentation of the region. Undefined when the file has no such region
+ * or the region no longer holds the first block as it was written.
+ */
+export declare function replaceInRegion(content: string, region: string, { replaced, by }: {
+    readonly replaced: string;
+    readonly by: string;
+}): string | undefined;
+//# sourceMappingURL=replace-in-region.d.ts.map

package/dist/markers/replace-in-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-in-region.d.ts","sourceRoot":"","sources":["../../src/markers/replace-in-region.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACnE,MAAM,GAAG,SAAS,CAoBpB"}

package/dist/markers/replace-in-region.js

@@ -0,0 +1,30 @@
+import { fitBlock } from '../layout/index.js';
+import { marker } from './marker.js';
+/**
+ * Replaces, inside a region, the lines a block was added as by the lines another block is added
+ * as, both laid out for the indentation of the region. Undefined when the file has no such region
+ * or the region no longer holds the first block as it was written.
+ */
+export function replaceInRegion(content, region, { replaced, by }) {
+    const lines = content.split('\n');
+    const open = lines.findIndex((line) => marker(region, false).test(line));
+    const close = lines.findIndex((line, index) => index > open && marker(region, true).test(line));
+    if (open === -1 || close === -1) {
+        return undefined;
+    }
+    const indent = /^\s*/.exec(lines[close] ?? '')?.[0] ?? '';
+    const inside = lines.slice(open + 1, close).join('\n');
+    const before = laidOut(replaced, indent);
+    if (before === '' || !inside.includes(before)) {
+        return undefined;
+    }
+    lines.splice(open + 1, close - open - 1, ...inside.replace(before, laidOut(by, indent)).split('\n'));
+    return lines.join('\n');
+}
+function laidOut(block, indent) {
+    const written = block.split('\n').filter((line) => line.trim() !== '');
+    return fitBlock(written, indent)
+        .map((line) => (line.trim() === '' ? '' : `${indent}${line}`))
+        .join('\n');
+}
+//# sourceMappingURL=replace-in-region.js.map

package/dist/markers/replace-in-region.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-in-region.js","sourceRoot":"","sources":["../../src/markers/replace-in-region.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,MAAc,EACd,EAAE,QAAQ,EAAE,EAAE,EAAsD;IAEpE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhG,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEzC,IAAI,MAAM,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAErG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,OAAO,CAAC,KAAa,EAAE,MAAc;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvE,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;SAC7B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;SAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/naming/index.d.ts

@@ -6,6 +6,8 @@ export { looksLikePastFact } from './looks-like-past-fact.js';
 export type { Name } from './name.js';
 export { parseConceptName } from './parse-concept-name.js';
 export { parseContextName } from './parse-context-name.js';
+export { plural } from './plural.js';
+export { singular } from './singular.js';
 export { splitWords } from './split-words.js';
 export { toName } from './to-name.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/naming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/naming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/naming/index.js

@@ -5,6 +5,8 @@ export { eventName } from './event-name.js';
 export { looksLikePastFact } from './looks-like-past-fact.js';
 export { parseConceptName } from './parse-concept-name.js';
 export { parseContextName } from './parse-context-name.js';
+export { plural } from './plural.js';
+export { singular } from './singular.js';
 export { splitWords } from './split-words.js';
 export { toName } from './to-name.js';
 //# sourceMappingURL=index.js.map

package/dist/naming/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/naming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/naming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/naming/plural.d.ts

@@ -0,0 +1,3 @@
+/** The plural of an English word, as the generator writes table names: `purchase_orders`, `deliveries`. */
+export declare function plural(word: string): string;
+//# sourceMappingURL=plural.d.ts.map

package/dist/naming/plural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural.d.ts","sourceRoot":"","sources":["../../src/naming/plural.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3C"}

package/dist/naming/plural.js

@@ -0,0 +1,8 @@
+/** The plural of an English word, as the generator writes table names: `purchase_orders`, `deliveries`. */
+export function plural(word) {
+    if (/[^aeiou]y$/.test(word)) {
+        return `${word.slice(0, -1)}ies`;
+    }
+    return /(?:s|x|z|ch|sh)$/.test(word) ? `${word}es` : `${word}s`;
+}
+//# sourceMappingURL=plural.js.map

package/dist/naming/plural.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural.js","sourceRoot":"","sources":["../../src/naming/plural.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;AAClE,CAAC"}

package/dist/naming/singular.d.ts

@@ -0,0 +1,3 @@
+/** The singular of a plural English word (`reminders`, `deliveries`, `boxes`), or undefined when it does not read as one. */
+export declare function singular(word: string): string | undefined;
+//# sourceMappingURL=singular.d.ts.map

package/dist/naming/singular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singular.d.ts","sourceRoot":"","sources":["../../src/naming/singular.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAC7H,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUzD"}

package/dist/naming/singular.js

@@ -0,0 +1,11 @@
+/** The singular of a plural English word (`reminders`, `deliveries`, `boxes`), or undefined when it does not read as one. */
+export function singular(word) {
+    if (/[^aeiou]ies$/.test(word)) {
+        return `${word.slice(0, -3)}y`;
+    }
+    if (/(?:ss|x|z|ch|sh)es$/.test(word)) {
+        return word.slice(0, -2);
+    }
+    return /[^su]s$/.test(word) ? word.slice(0, -1) : undefined;
+}
+//# sourceMappingURL=singular.js.map

package/dist/naming/singular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singular.js","sourceRoot":"","sources":["../../src/naming/singular.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAC7H,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,CAAC;IAED,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9D,CAAC"}

package/dist/naming/to-name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-name.d.ts","sourceRoot":"","sources":["../../src/naming/to-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAgB1C"}
+{"version":3,"file":"to-name.d.ts","sourceRoot":"","sources":["../../src/naming/to-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAItC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAgB1C"}

package/dist/naming/to-name.js

@@ -1,4 +1,5 @@
 import { capitalize } from './capitalize.js';
+import { plural as pluralize } from './plural.js';
 import { splitWords } from './split-words.js';
 export function toName(input) {
     const words = splitWords(input);
@@ -16,10 +17,4 @@ export function toName(input) {
         tableCamel: plural.map((word, index) => (index === 0 ? word : capitalize(word))).join(''),
     };
 }
-function pluralize(word) {
-    if (/[^aeiou]y$/.test(word)) {
-        return `${word.slice(0, -1)}ies`;
-    }
-    return /(?:s|x|z|ch|sh)$/.test(word) ? `${word}es` : `${word}s`;
-}
 //# sourceMappingURL=to-name.js.map

package/dist/naming/to-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-name.js","sourceRoot":"","sources":["../../src/naming/to-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEtE,OAAO;QACL,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACtB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;QACvC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACtB,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG;QACrD,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;KAC1F,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;AAClE,CAAC"}
+{"version":3,"file":"to-name.js","sourceRoot":"","sources":["../../src/naming/to-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEtE,OAAO;QACL,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACtB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;QACvC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACtB,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG;QACrD,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;KAC1F,CAAC;AACJ,CAAC"}

package/dist/sdk/agent-instruction.d.ts

@@ -1,3 +1,3 @@
-/** What the CLAUDE.md of a project with clients tells its agents, at `init --sdk` and when `ddd-ts-kit sdk` asks for them later. */
+/** What the AGENTS.md of a project with clients tells its agents, at `init --sdk` and when `ddd-ts-kit sdk` asks for them later. */
 export declare const AGENT_INSTRUCTION = "Never edit the clients under `clients/`, except the version and your own keys in their `package.json`: `npm run docs:generate` (`npx ddd-ts-kit sdk`) rewrites them from the contract, `docs:check` fails while they differ from it. A spec or a script calls the API through a client by its package name, which the command resolves to its sources under `paths` in `tsconfig.json`.";
 //# sourceMappingURL=agent-instruction.d.ts.map

package/dist/sdk/agent-instruction.js

@@ -1,3 +1,3 @@
-/** What the CLAUDE.md of a project with clients tells its agents, at `init --sdk` and when `ddd-ts-kit sdk` asks for them later. */
+/** What the AGENTS.md of a project with clients tells its agents, at `init --sdk` and when `ddd-ts-kit sdk` asks for them later. */
 export const AGENT_INSTRUCTION = 'Never edit the clients under `clients/`, except the version and your own keys in their `package.json`: `npm run docs:generate` (`npx ddd-ts-kit sdk`) rewrites them from the contract, `docs:check` fails while they differ from it. A spec or a script calls the API through a client by its package name, which the command resolves to its sources under `paths` in `tsconfig.json`.';
 //# sourceMappingURL=agent-instruction.js.map

package/dist/sdk/instruct-agents.d.ts

@@ -1,7 +1,7 @@
 import type { Workspace } from '../workspace/index.js';
 /**
  * What `init --sdk` writes for the agents of a project, in one that asks for clients later: the
- * instruction of CLAUDE.md, appended once, and a note for the paths of the presentation rule,
+ * instruction of its guide, appended once, and a note for the paths of the presentation rules,
  * which the team may have rewritten.
  */
 export declare function instructAgents(ws: Workspace): void;

package/dist/sdk/instruct-agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instruct-agents.d.ts","sourceRoot":"","sources":["../../src/sdk/instruct-agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMvD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAWlD"}
+{"version":3,"file":"instruct-agents.d.ts","sourceRoot":"","sources":["../../src/sdk/instruct-agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAclD"}

package/dist/sdk/instruct-agents.js

@@ -1,19 +1,23 @@
 import { AGENT_INSTRUCTION } from './agent-instruction.js';
-const INSTRUCTIONS = 'CLAUDE.md';
-const PRESENTATION_RULE = '.claude/rules/presentation.md';
+/** The guide of every agent; a project written before it kept its instructions in CLAUDE.md. */
+const GUIDES = ['AGENTS.md', 'CLAUDE.md'];
+const PRESENTATION_RULES = ['.claude/rules/presentation.md', '.github/instructions/presentation.instructions.md'];
 /**
  * What `init --sdk` writes for the agents of a project, in one that asks for clients later: the
- * instruction of CLAUDE.md, appended once, and a note for the paths of the presentation rule,
+ * instruction of its guide, appended once, and a note for the paths of the presentation rules,
  * which the team may have rewritten.
  */
 export function instructAgents(ws) {
-    const instructions = ws.read(INSTRUCTIONS);
+    const guide = GUIDES.find((file) => ws.exists(file));
+    const instructions = guide === undefined ? undefined : ws.read(guide);
     const instruction = ws.spoken(AGENT_INSTRUCTION);
-    if (instructions !== undefined && !instructions.includes(instruction)) {
-        ws.update(INSTRUCTIONS, `${instructions}${instructions.endsWith('\n') ? '' : '\n'}\n${instruction}\n`);
+    if (guide !== undefined && instructions !== undefined && !instructions.includes(instruction)) {
+        ws.update(guide, `${instructions}${instructions.endsWith('\n') ? '' : '\n'}\n${instruction}\n`);
     }
-    if (!(ws.read(PRESENTATION_RULE) ?? '"clients/**"').includes('"clients/**"')) {
-        ws.note(`${PRESENTATION_RULE}: add "clients/**" to its paths, so that an agent editing a client reads it.`);
+    for (const rule of PRESENTATION_RULES) {
+        if (!(ws.read(rule) ?? 'clients/**').includes('clients/**')) {
+            ws.note(`${rule}: add "clients/**" to its paths, so that an agent editing a client reads it.`);
+        }
     }
 }
 //# sourceMappingURL=instruct-agents.js.map

package/dist/sdk/instruct-agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"instruct-agents.js","sourceRoot":"","sources":["../../src/sdk/instruct-agents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAa;IAC1C,MAAM,YAAY,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAEjD,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACtE,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC;IACzG,CAAC;IAED,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,cAAc,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7E,EAAE,CAAC,IAAI,CAAC,GAAG,iBAAiB,8EAA8E,CAAC,CAAC;IAC9G,CAAC;AACH,CAAC"}
+{"version":3,"file":"instruct-agents.js","sourceRoot":"","sources":["../../src/sdk/instruct-agents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,gGAAgG;AAChG,MAAM,MAAM,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAC1C,MAAM,kBAAkB,GAAG,CAAC,+BAA+B,EAAE,mDAAmD,CAAC,CAAC;AAElH;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAa;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAEjD,IAAI,KAAK,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7F,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC;IAClG,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5D,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,8EAA8E,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

@@ -1,7 +1,28 @@
 {
   "name": "ddd-ts-kit",
-  "version": "0.16.1",
-  "description": "Bootstrap, scaffold and verify DDD and Clean Architecture TypeScript projects.",
+  "version": "0.18.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",
+    "domain-driven-design",
+    "clean-architecture",
+    "hexagonal-architecture",
+    "typescript",
+    "cli",
+    "scaffolding",
+    "code-generator",
+    "project-generator",
+    "architecture-testing",
+    "cqrs",
+    "event-sourcing",
+    "modular-monolith",
+    "microservices",
+    "nodejs",
+    "claude-code",
+    "codex",
+    "github-copilot",
+    "ai-agents"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -29,6 +50,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.16.1"
+    "@ddd-ts-kit/kernel": "^0.18.0"
   }
 }

package/templates/command/handler.declared.ts.tpl

@@ -1,8 +1,14 @@
 {{#if command.hasAggregate}}
+{{#if access.policy}}
+import type { Access } from '@ddd-ts-kit/auth';
+{{/if}}
 import type { Clock, IdGenerator } from '@ddd-ts-kit/kernel';
 import { CommandHandler } from '@ddd-ts-kit/kernel/declarations';
 import { {{aggregate.pascal}} } from '{{alias.context}}/domain/aggregates/{{aggregate.kebab}}.aggregate{{alias.ext}}';
 import type { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository{{alias.ext}}';
+{{#if access.policy}}
+{{access.useCasePermissionsImport}}
+{{/if}}
 import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
 
 @CommandHandler({{name.pascal}}Command)
@@ -11,30 +17,53 @@ export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Com
     private readonly {{aggregate.camel}}Repository: {{aggregate.pascal}}Repository,
     private readonly ids: IdGenerator,
     private readonly clock: Clock,
+{{#if access.policy}}
+    private readonly access: Access,
+{{/if}}
   ) {}
 
   async execute(command: {{name.pascal}}Command): Promise<string> {
+{{#if access.policy}}
+    // TODO(domain): a policy refines {{access.reference}}: ask it about the element "{{name.words}}" acts on once it is loaded, in place of `command`.
+    await this.access.authorize(command.actor, {{access.reference}}, command);
+
+{{/if}}
 {{#if refusals.factories}}
     // TODO(domain): decide what "{{name.words}}" does to a {{aggregate.pascal}}: either it gives birth to one (keep `create`, pass the facts of `command` as value objects), or it changes an existing one (load it with `findById`, throw its not-found refusal, `{{aggregate.pascal}}Error.notFound(id)` (`ddd-ts-kit generate error {{context.kebab}} {{aggregate.pascal}} notFound`), call ONE intention method). The events it records leave with the save: nothing else to do here.
 {{/if}}
 {{#if refusals.classes}}
     // TODO(domain): decide what "{{name.words}}" does to a {{aggregate.pascal}}: either it gives birth to one (keep `create`, pass the facts of `command` as value objects), or it changes an existing one (load it with `findById`, throw a not-found DomainError, call ONE intention method). The events it records leave with the save: nothing else to do here.
 {{/if}}
-    const target = {{aggregate.pascal}}.create(this.ids.next(), this.clock.now());
+    const {{aggregate.camel}} = {{aggregate.pascal}}.create(this.ids.next(), this.clock.now());
 
-    await this.{{aggregate.camel}}Repository.save(target);
+    await this.{{aggregate.camel}}Repository.save({{aggregate.camel}});
 
-    return target.id;
+    return {{aggregate.camel}}.id;
   }
 }
 {{/if}}
 {{#unless command.hasAggregate}}
+{{#if access.policy}}
+import type { Access } from '@ddd-ts-kit/auth';
+{{/if}}
 import { CommandHandler } from '@ddd-ts-kit/kernel/declarations';
+{{#if access.policy}}
+{{access.useCasePermissionsImport}}
+{{/if}}
 import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
 
 @CommandHandler({{name.pascal}}Command)
 export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Command> {
+{{#if access.policy}}
+  constructor(private readonly access: Access) {}
+
+{{/if}}
   async execute(command: {{name.pascal}}Command): Promise<void> {
+{{#if access.policy}}
+    // TODO(domain): a policy refines {{access.reference}}: ask it about the element "{{name.words}}" acts on once it is loaded, in place of `command`.
+    await this.access.authorize(command.actor, {{access.reference}}, command);
+
+{{/if}}
     // TODO(domain): receive the repository of the aggregate "{{name.words}}" acts on in the constructor, typed by its port (rerun with --aggregate <Name> --force to get it declared), load or create the aggregate from `command`, call its intention method and save it (its events leave with the save); the unit of work is opened by the command bus.
   }
 }

package/templates/command/handler.spec.buses.ts.tpl

@@ -1,6 +1,11 @@
 import { describe, expect, it } from '{{tests.module}}';
 {{#if access.protected}}
+{{#if access.policy}}
+import { AuthorizationMap, PolicyAccess, RoleBasedAuthorizer, authorizationMiddleware, requires } from '@ddd-ts-kit/auth';
+{{/if}}
+{{#unless access.policy}}
 import { AuthorizationMap, RoleBasedAuthorizer, authorizationMiddleware, requires } from '@ddd-ts-kit/auth';
+{{/unless}}
 import { anActor } from '@ddd-ts-kit/auth/testing';
 {{/if}}
 import { createTestBuses } from '@ddd-ts-kit/testing';
@@ -14,12 +19,22 @@ import { Fake{{aggregate.pascal}}Repository } from '{{alias.context}}/test/fakes
 {{/if}}
 {{#if access.protected}}
 
+{{#if access.policy}}
+const authorizer = new RoleBasedAuthorizer({ roles: { holder: [{{context.camel}}Permissions['{{access.permission}}']] } });
+
+const holders = authorizationMiddleware({
+  authorizer,
+  map: AuthorizationMap.of(requires({{name.pascal}}Command, {{context.camel}}Permissions['{{access.permission}}'])),
+});
+{{/if}}
+{{#unless access.policy}}
 const holders = authorizationMiddleware({
   authorizer: new RoleBasedAuthorizer({
     roles: { holder: [{{context.camel}}Permissions['{{access.permission}}']] },
   }),
   map: AuthorizationMap.of(requires({{name.pascal}}Command, {{context.camel}}Permissions['{{access.permission}}'])),
 });
+{{/unless}}
 
 const holder = anActor().withRole('holder').build();
 {{/if}}
@@ -71,16 +86,24 @@ function arrange() {
   // As the application hands it to the handler: the save announces the events of the {{aggregate.words}} to `domainEvents`.
   const {{aggregate.camel}}Repository = dispatching(new Fake{{aggregate.pascal}}Repository());
 
-  const handler = new {{name.pascal}}Handler({{aggregate.camel}}Repository, ids, clock);
+  const handler = new {{name.pascal}}Handler({{aggregate.camel}}Repository, ids, clock{{#if access.policy}}, new PolicyAccess({ authorizer, clock }){{/if}});
 
   commandBus{{spec.guard}}.register({{name.pascal}}Command, handler);
 
   return { commandBus, {{aggregate.camel}}Repository, domainEvents };
   {{/if}}
   {{#unless command.hasAggregate}}
+{{#if access.policy}}
+  const { commandBus, clock } = createTestBuses();
+  const handler = new {{name.pascal}}Handler(new PolicyAccess({ authorizer, clock }));
+
+  commandBus{{spec.guard}}.register({{name.pascal}}Command, handler);
+{{/if}}
+{{#unless access.policy}}
   const { commandBus } = createTestBuses();
 
   commandBus{{spec.guard}}.register({{name.pascal}}Command, new {{name.pascal}}Handler());
+{{/unless}}
 
   return { commandBus };
   {{/unless}}

package/templates/command/handler.ts.tpl

@@ -1,7 +1,13 @@
 {{#if command.hasAggregate}}
+{{#if access.policy}}
+import type { Access } from '@ddd-ts-kit/auth';
+{{/if}}
 import type { Clock, CommandHandler, IdGenerator } from '@ddd-ts-kit/kernel';
 import { {{aggregate.pascal}} } from '{{alias.context}}/domain/aggregates/{{aggregate.kebab}}.aggregate{{alias.ext}}';
 import type { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository{{alias.ext}}';
+{{#if access.policy}}
+{{access.useCasePermissionsImport}}
+{{/if}}
 import type { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
 
 export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Command> {
@@ -9,29 +15,52 @@ export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Com
     private readonly {{aggregate.camel}}Repository: {{aggregate.pascal}}Repository,
     private readonly ids: IdGenerator,
     private readonly clock: Clock,
+{{#if access.policy}}
+    private readonly access: Access,
+{{/if}}
   ) {}
 
   async execute(command: {{name.pascal}}Command): Promise<string> {
+{{#if access.policy}}
+    // TODO(domain): a policy refines {{access.reference}}: ask it about the element "{{name.words}}" acts on once it is loaded, in place of `command`.
+    await this.access.authorize(command.actor, {{access.reference}}, command);
+
+{{/if}}
 {{#if refusals.factories}}
     // TODO(domain): decide what "{{name.words}}" does to a {{aggregate.pascal}}: either it gives birth to one (keep `create`, pass the facts of `command` as value objects), or it changes an existing one (load it with `findById`, throw its not-found refusal, `{{aggregate.pascal}}Error.notFound(id)` (`ddd-ts-kit generate error {{context.kebab}} {{aggregate.pascal}} notFound`), call ONE intention method). The events it records leave with the save: nothing else to do here.
 {{/if}}
 {{#if refusals.classes}}
     // TODO(domain): decide what "{{name.words}}" does to a {{aggregate.pascal}}: either it gives birth to one (keep `create`, pass the facts of `command` as value objects), or it changes an existing one (load it with `findById`, throw a not-found DomainError, call ONE intention method). The events it records leave with the save: nothing else to do here.
 {{/if}}
-    const target = {{aggregate.pascal}}.create(this.ids.next(), this.clock.now());
+    const {{aggregate.camel}} = {{aggregate.pascal}}.create(this.ids.next(), this.clock.now());
 
-    await this.{{aggregate.camel}}Repository.save(target);
+    await this.{{aggregate.camel}}Repository.save({{aggregate.camel}});
 
-    return target.id;
+    return {{aggregate.camel}}.id;
   }
 }
 {{/if}}
 {{#unless command.hasAggregate}}
+{{#if access.policy}}
+import type { Access } from '@ddd-ts-kit/auth';
+{{/if}}
 import type { CommandHandler } from '@ddd-ts-kit/kernel';
+{{#if access.policy}}
+{{access.useCasePermissionsImport}}
+{{/if}}
 import type { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
 
 export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Command> {
+{{#if access.policy}}
+  constructor(private readonly access: Access) {}
+
+{{/if}}
   async execute(command: {{name.pascal}}Command): Promise<void> {
+{{#if access.policy}}
+    // TODO(domain): a policy refines {{access.reference}}: ask it about the element "{{name.words}}" acts on once it is loaded, in place of `command`.
+    await this.access.authorize(command.actor, {{access.reference}}, command);
+
+{{/if}}
     // TODO(domain): receive the repository of the aggregate "{{name.words}}" acts on in the constructor (rerun with --aggregate <Name> --force to get it wired), load or create the aggregate from `command`, call its intention method and save it (its events leave with the save); the unit of work is opened by the command bus.
   }
 }

package/templates/command/wiring.manual.tpl

@@ -5,10 +5,10 @@ import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{
 import { {{name.pascal}}Handler } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.handler{{alias.ext}}';
 @@registrations
 {{#if command.hasAggregate}}
-platform.commands.register({{name.pascal}}Command, new {{name.pascal}}Handler({{aggregate.camel}}Repository, platform.ids, platform.clock), { context: '{{context.kebab}}' });
+platform.commands.register({{name.pascal}}Command, new {{name.pascal}}Handler({{aggregate.camel}}Repository, platform.ids, platform.clock{{#if access.policy}}, platform.access{{/if}}), { context: '{{context.kebab}}' });
 {{/if}}
 {{#unless command.hasAggregate}}
-platform.commands.register({{name.pascal}}Command, new {{name.pascal}}Handler(), { context: '{{context.kebab}}' });
+platform.commands.register({{name.pascal}}Command, new {{name.pascal}}Handler({{#if access.policy}}platform.access{{/if}}), { context: '{{context.kebab}}' });
 {{/unless}}
 @@authorization
 {{access.manualDeclaration}}

package/templates/command/wiring.tsyringe.tpl

@@ -1,4 +1,7 @@
 @@imports
+{{#if access.policy}}
+import { Access } from '@ddd-ts-kit/auth';
+{{/if}}
 {{#if command.hasAggregate}}
 import { Clock, IdGenerator } from '@ddd-ts-kit/kernel';
 import { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository{{alias.ext}}';
@@ -8,8 +11,8 @@ import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{
 import { {{name.pascal}}Handler } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.handler{{alias.ext}}';
 @@registrations
 {{#if command.hasAggregate}}
-builder.command({{name.pascal}}Command){{access.declaration}}.handledBy({{name.pascal}}Handler, [{{aggregate.pascal}}Repository, IdGenerator, Clock]);
+builder.command({{name.pascal}}Command){{access.declaration}}.handledBy({{name.pascal}}Handler, [{{aggregate.pascal}}Repository, IdGenerator, Clock{{#if access.policy}}, Access{{/if}}]);
 {{/if}}
 {{#unless command.hasAggregate}}
-builder.command({{name.pascal}}Command){{access.declaration}}.handledBy({{name.pascal}}Handler);
+builder.command({{name.pascal}}Command){{access.declaration}}.handledBy({{name.pascal}}Handler{{#if access.policy}}, [Access]{{/if}});
 {{/unless}}

package/templates/controller/controller.search.ts.tpl

@@ -90,7 +90,7 @@ export class {{name.pascal}}Controller {
     // TODO(domain): hand the criteria of the query over too, once the query schema declares them next to the page (a request mapper is their place); map each line to its public fields.
     const page = await this.queries.execute(new {{route.input}}(request.actor, request.query));
 
-    return pageResponse(page, (item) => ({ id: item.id }));
+    return pageResponse(page, ({{search.element}}) => ({ id: {{search.element}}.id }));
   }
 }
 {{#if search.customSchema}}

package/templates/event-handler/event-handler.declared.ts.tpl

@@ -1,7 +1,7 @@
 import { DomainEventHandler } from '@ddd-ts-kit/kernel/declarations';
 import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
 
-@DomainEventHandler({{event.pascal}}, { name: {{event.reference}}{{#if handler.afterCommit}}, phase: 'after-commit'{{/if}} })
+@DomainEventHandler({{event.pascal}}{{#if handler.afterCommit}}, { phase: 'after-commit' }{{/if}})
 export class {{event.pascal}}EventHandler implements DomainEventHandler<{{event.pascal}}> {
   async handle(event: {{event.pascal}}): Promise<void> {
 {{#unless handler.afterCommit}}

package/templates/init/AGENTS.md.tpl

@@ -0,0 +1,46 @@
+# {{project.name}}
+
+A ddd-ts-kit project: one bounded context per directory of `{{config.contextsDir}}/`, each described by its `CONTEXT.md`. The plan and what is next: `docs/architecture/plan.md`, when the project follows the method.
+
+## Commands
+
+- `npm run verify`: types, lint, format, tests with the coverage thresholds of `ddd-ts-kit.config.json` (per context and layer), architecture rules, import graph, dead code, documentation drift. Once, before a commit that closes a slice. A layer under its threshold gets the missing test, never an exclusion.
+- `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.
+
+## Read less
+
+1. `describe <context> --json` and the `CONTEXT.md` of the context before the tree: do not browse `{{config.sourceRoot}}/` to learn what exists.
+2. Open only what the `next` list of a generator (`file:line`) or a violation names.
+3. `check --changed-since <ref>` and the tests of the context while iterating; `npm run verify` once at the end.
+
+## Rules by layer
+
+One file per layer in `.claude/rules/`: `domain.md` (`domain/`, the shared kernel), `application.md`, `published-language.md`, `infrastructure.md`, `presentation.md` (and the OpenAPI contract), `platform.md` (`{{config.platformDir}}/`, `main.ts`, `apps/`{{#if style.explicit}}, module files{{/if}}), `tests.md` (specs, fakes, builders, `test/`). The same text is in `.github/instructions/<layer>.instructions.md`. Claude Code and GitHub Copilot load it with the files it applies to; an agent that does not (Codex) reads the file of a layer before it edits a file of that layer.
+
+## Generated files
+
+Create every file of a role with `npx ddd-ts-kit generate <kind> ... --json`, then fill the `TODO(domain)` places it lists; never write one by hand, never restructure what a generator wrote.
+{{#if assembly.barrel}}
+Never edit `<context>.declarations.ts`: `generate`, `docs` and `npm run dev` rewrite it, from the role files and from the constructor signatures (it registers what each constructor is injected). After changing a constructor by hand, `npx ddd-ts-kit docs`.
+{{/if}}
+{{#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`).
+{{#if sdk.on}}
+{{sdk.instruction}}
+{{/if}}
+Imports: a file of the project is imported by its alias from the project root, never by a relative path, the same directory included: `{{alias.source}}/...` for `{{config.sourceRoot}}/`, `{{alias.test}}/...` for `test/`, `{{alias.scripts}}/...` for `scripts/`, {{#if alias.extensionless}}never ending in `.js` or `.ts`, and naming a file, never a directory{{/if}}{{#unless alias.extensionless}}always ending in `.js`{{/unless}} (`imports/alias-only`, `imports/extension`; `npm run lint:fix` rewrites a relative import and a wrong ending). The alias is declared once, under `paths` in `tsconfig.json`, from `importAlias` of `ddd-ts-kit.config.json`, and the ending follows `importExtension`: never add a second entry or mapping, never change `module` or `moduleResolution` in `tsconfig.json`, and never compile without `npm run build`, which rewrites the aliases of `dist/` into relative paths ending in `.js` for Node (`imports/alias-declared`).
+Everywhere: one exported class, interface or function per file, named after it in kebab-case; at most 350 lines a file, 30 lines and 3 parameters a function; `private` members, never `#name`; a blank line before a `return` and around `if`, `for`, `try` (`npm run lint:fix`); braces around the body of every `if`, `else`, `for`, `while` and `do`, on its own lines: a branch is visible at a glance, and a statement added to it later cannot silently fall outside it. `npm run format` (Biome, line width 120) lays out every file: do not spend tokens on line breaks.
+
+## TypeScript
+
+The compiler is the native TypeScript 7, installed as `@typescript/native`; `typescript` 6 is there for the tools that need its API (ESLint, dependency-cruiser). Use `npm run typecheck` and `npm run build`, never `npx tsc`, which would run version 6.
+
+## Workflow
+
+Follow the recommended steps in order, the supported path (`README.md`, "Recommended steps"): discover the domain, bounded contexts, glossaries, context map, bootstrap, plan the slices, build slice by slice, quality gate, document. `npx ddd-ts-kit status` says where the project stands. When asked to skip a step, say which one and what it costs, and record it in `docs/architecture/plan.md`.
+With the ddd-ts-kit plugin: `/ddd-ts-kit:start` for a new project or to resume one, `/ddd-ts-kit:glossary` before a new name, `/ddd-ts-kit:use-case` for a feature, `/ddd-ts-kit:document` for the contracts, `/ddd-ts-kit:quality-gate` before a pull or merge request. The plugin installs in Claude Code, Codex and the Copilot CLI from the marketplace `gbourgeat/ddd-ts-kit`; Codex calls a skill by its name, `$start`, `$use-case`.