@metaobjectsdev/codegen-ts 0.23.2 → 0.24.0

package/dist/generators/docs-file.js

@@ -17,7 +17,7 @@
 // byte-identity — the codegen output must match the hand-coded rc.11
 // byte-for-byte. If you're hacking on this and the conformance test
 // breaks, the refactor is the bug, not the fixture.
-import { TYPE_TEMPLATE, TEMPLATE_SUBTYPE_OUTPUT } from "@metaobjectsdev/metadata";
+import { TYPE_TEMPLATE } from "@metaobjectsdev/metadata";
 import { render } from "@metaobjectsdev/render";
 import { docPageOutputPath, docPageHref, docPageNode, apiSurfaceHref, assertNoDuplicateDocPaths, } from "../docs-paths.js";
 import { projectProvider } from "../render-engine/framework-provider.js";
@@ -101,12 +101,21 @@ export const docsFile = function docsFile(opts) {
                 });
                 return { path, content: renderDocPage(TEMPLATE_REF, payload, provider, path) };
             });
-            // ALSO emit one NEUTRAL render-contract page per `template.output` node —
-            // a sibling artifact, distinct from the entity page. Raw node name → file
+            // ALSO emit one NEUTRAL render-contract page per top-level `template.*` node
+            // — a sibling artifact, distinct from the entity page. Raw node name → file
             // (`<name>.md`), agreeing with the entity Used-by back-link target.
+            //
+            // EVERY template subtype, not just `template.output`: the api-docs surface
+            // has always emitted `api/<lang>/<pkg>/<Prompt>.md` for a top-level
+            // `template.prompt` (it documents the prompt-render handle), and that page
+            // carries a "Model / metadata" back-link to `<pkg>/<Prompt>.md`. While this
+            // loop filtered to outputs, that link pointed at a page nothing wrote — a
+            // broken link in every shipped doc tree containing a prompt. ADR-0052 makes
+            // it worse rather than better: a responding prompt now carries the whole
+            // inbound tier, so it is the LAST node a doc tree should omit.
             // ADR-0039: resolving — root has no super (children()==ownChildren()).
             for (const child of ctx.loadedRoot.children()) {
-                if (child.type !== TYPE_TEMPLATE || child.subType !== TEMPLATE_SUBTYPE_OUTPUT)
+                if (child.type !== TYPE_TEMPLATE)
                     continue;
                 const node = docPageNode(child);
                 templateNodes.push(node);

package/dist/generators/docs-file.js.map

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

package/dist/generators/extractor-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor-file.d.ts","sourceRoot":"","sources":["../../src/generators/extractor-file.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,aAAa;IAC5B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,SAAS,EAgCjB,gBAAgB,CAAC,aAAa,CAAC,CAAC"}
+{"version":3,"file":"extractor-file.d.ts","sourceRoot":"","sources":["../../src/generators/extractor-file.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAIzB,MAAM,WAAW,aAAa;IAC5B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,SAAS,EA4BjB,gBAAgB,CAAC,aAAa,CAAC,CAAC"}

package/dist/generators/extractor-file.js

@@ -4,7 +4,7 @@
 // node whose @format is json/xml. Wraps renderExtractor() from templates/extractor.ts.
 //
 // The emitted extractor sits over the output-parser's nested-capable extract and turns dirty LLM
-// text into the strict typed payload graph. It imports from the sibling <Name>.output.ts (the
+// text into the strict typed payload graph. It imports from the sibling <Name>.response.ts (the
 // output-parser) and from each payload value-object's own entity module (<VO>.ts, emitted by
 // entityFile), so run it alongside outputParser() + entityFile().
 //
@@ -13,24 +13,20 @@
 //
 // Custom output directory:
 //   generators: [..., extractor({ outDir: "src/generated/outputs" })]
-import { TYPE_TEMPLATE, TEMPLATE_SUBTYPE_OUTPUT, TEMPLATE_ATTR_FORMAT } from "@metaobjectsdev/metadata";
 import { oncePerRun, } from "../generator.js";
+import { inboundTemplates, responseShape } from "../templates/find-inbound.js";
 import { renderExtractor } from "../templates/extractor.js";
 export const extractor = function extractor(opts) {
     const dirPrefix = opts?.outDir ? `${opts.outDir.replace(/\/$/, "")}/` : "";
     const generator = {
         name: "extractor",
         generate: oncePerRun((_entities, ctx) => {
-            // ADR-0039: resolving — root has no super (children()==ownChildren()).
-            const outputs = ctx.loadedRoot
-                .children()
-                .filter((c) => c.type === TYPE_TEMPLATE && c.subType === TEMPLATE_SUBTYPE_OUTPUT);
             const files = [];
-            for (const t of outputs) {
-                // The extract tier requires the extract API, which only json/xml output-parsers emit.
-                // ADR-0039: resolving — a template may inherit @format via extends.
-                const format = (t.attr(TEMPLATE_ATTR_FORMAT) ?? "text").toLowerCase();
-                if (format !== "json" && format !== "xml")
+            for (const t of inboundTemplates(ctx.loadedRoot)) {
+                // The extract tier sits over the parser's extract API. Since ADR-0052 every
+                // responding prompt emits one (@responseFormat is a closed json|xml set), so
+                // the only remaining skip is an unresolvable @responseRef.
+                if (!responseShape(ctx.loadedRoot, t))
                     continue;
                 files.push({
                     path: `${dirPrefix}${t.name}.extractor.ts`,

package/dist/generators/extractor-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"extractor-file.js","sourceRoot":"","sources":["../../src/generators/extractor-file.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,+FAA+F;AAC/F,uFAAuF;AACvF,EAAE;AACF,iGAAiG;AACjG,8FAA8F;AAC9F,6FAA6F;AAC7F,kEAAkE;AAClE,EAAE;AACF,2CAA2C;AAC3C,mDAAmD;AACnD,EAAE;AACF,2BAA2B;AAC3B,sEAAsE;AAEtE,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACxG,OAAO,EAIL,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAS5D,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,SAAS,CAAC,IAAoB;IAC9D,MAAM,SAAS,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE;YACtC,uEAAuE;YACvE,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU;iBAC3B,QAAQ,EAAE;iBACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,OAAO,KAAK,uBAAuB,CAAC,CAAC;YACpF,MAAM,KAAK,GAAkB,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,sFAAsF;gBACtF,oEAAoE;gBACpE,MAAM,MAAM,GAAG,CAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAwB,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC9F,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK;oBAAE,SAAS;gBACpD,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,eAAe;oBAC1C,qFAAqF;oBACrF,uFAAuF;oBACvF,uFAAuF;oBACvF,+EAA+E;oBAC/E,yBAAyB;oBACzB,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC;iBACpE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;KACH,CAAC;IACF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAoC,CAAC"}
+{"version":3,"file":"extractor-file.js","sourceRoot":"","sources":["../../src/generators/extractor-file.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,+FAA+F;AAC/F,uFAAuF;AACvF,EAAE;AACF,iGAAiG;AACjG,gGAAgG;AAChG,6FAA6F;AAC7F,kEAAkE;AAClE,EAAE;AACF,2CAA2C;AAC3C,mDAAmD;AACnD,EAAE;AACF,2BAA2B;AAC3B,sEAAsE;AAEtE,OAAO,EAIL,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAS5D,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,SAAS,CAAC,IAAoB;IAC9D,MAAM,SAAS,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE;YACtC,MAAM,KAAK,GAAkB,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjD,4EAA4E;gBAC5E,6EAA6E;gBAC7E,2DAA2D;gBAC3D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;oBAAE,SAAS;gBAChD,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,eAAe;oBAC1C,qFAAqF;oBACrF,uFAAuF;oBACvF,uFAAuF;oBACvF,+EAA+E;oBAC/E,yBAAyB;oBACzB,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC;iBACpE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;KACH,CAAC;IACF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAoC,CAAC"}

package/dist/generators/index.d.ts

@@ -25,4 +25,8 @@ export type { EntityDocData, StorageFieldDoc, IdentityDoc, RelationshipDoc, Used
 export { buildEntityDocData } from "./docs-data-builder.js";
 export type { TemplateDocData, TemplateOutputPart } from "./template-doc-data.js";
 export { buildTemplateDocData } from "./template-doc-builder.js";
+export { requirementTests } from "./requirement-tests.js";
+export { requirementsFile } from "./requirements-file.js";
+export type { RequirementRow } from "./requirements-view.js";
+export type { RequirementTestsOpts, RequirementTestRenderer, } from "./requirement-tests.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAOA,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnE,2IAA2I;AAC3I,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzE,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChF,qIAAqI;AACrI,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,gIAAgI;AAChI,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,oKAAoK;AACpK,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACvE,iJAAiJ;AACjJ,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,EACf,SAAS,EACT,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAOA,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnE,2IAA2I;AAC3I,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzE,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChF,qIAAqI;AACrI,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,gIAAgI;AAChI,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,oKAAoK;AACpK,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACvE,iJAAiJ;AACjJ,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,EACf,SAAS,EACT,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EACV,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/generators/index.js

@@ -29,4 +29,9 @@ export { templateGenerator, } from "./template-generator.js";
 export { traceHelperFile } from "./trace-helper-file.js";
 export { buildEntityDocData } from "./docs-data-builder.js";
 export { buildTemplateDocData } from "./template-doc-builder.js";
+// FR-038 — requirement-derived test stubs. The factory is a convenience; the
+// primitives beside it are the real escape hatch, so an app needing different
+// behaviour composes its own generator instead of filing an issue here.
+export { requirementTests } from "./requirement-tests.js";
+export { requirementsFile } from "./requirements-file.js";
 //# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,sFAAsF;AACtF,sFAAsF;AACtF,iFAAiF;AACjF,mFAAmF;AACnF,sFAAsF;AAEtF,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AACnE,2IAA2I;AAC3I,OAAO,EAAE,WAAW,EAAwB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AACzE,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAChF,qIAAqI;AACrI,OAAO,EAAE,MAAM,EAAmB,MAAM,aAAa,CAAC;AACtD,gIAAgI;AAChI,OAAO,EAAE,gBAAgB,EAAyB,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,oKAAoK;AACpK,OAAO,EAAE,WAAW,EAAwB,MAAM,oBAAoB,CAAC;AACvE,iJAAiJ;AACjJ,OAAO,EAAE,QAAQ,EAAqB,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAwB,MAAM,wBAAwB,CAAC;AAS/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,sFAAsF;AACtF,sFAAsF;AACtF,iFAAiF;AACjF,mFAAmF;AACnF,sFAAsF;AAEtF,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AACnE,2IAA2I;AAC3I,OAAO,EAAE,WAAW,EAAwB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AACzE,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAChF,qIAAqI;AACrI,OAAO,EAAE,MAAM,EAAmB,MAAM,aAAa,CAAC;AACtD,gIAAgI;AAChI,OAAO,EAAE,gBAAgB,EAAyB,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,oKAAoK;AACpK,OAAO,EAAE,WAAW,EAAwB,MAAM,oBAAoB,CAAC;AACvE,iJAAiJ;AACjJ,OAAO,EAAE,QAAQ,EAAqB,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAwB,MAAM,wBAAwB,CAAC;AAS/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/generators/output-parser-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-parser-file.d.ts","sourceRoot":"","sources":["../../src/generators/output-parser-file.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,YAAY,EAyBpB,gBAAgB,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"output-parser-file.d.ts","sourceRoot":"","sources":["../../src/generators/output-parser-file.ts"],"names":[],"mappings":"AAkBA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,YAAY,EAyBpB,gBAAgB,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/generators/output-parser-file.js

@@ -1,15 +1,20 @@
 // server/typescript/packages/codegen-ts/src/generators/output-parser-file.ts
 //
-// Stock generator that emits one <TemplateName>.output.ts file per declared
-// template.output node. Wraps renderOutputParser() from templates/output-parser.ts.
+// Stock generator that emits one <PromptName>.response.ts file per declared
+// `template.prompt` carrying `@responseRef`. Wraps renderOutputParser() from
+// templates/output-parser.ts.
+//
+// ADR-0052: this tier is INBOUND — it reads a model's reply. It used to key on
+// `template.output` with no `@kind` filter at all, so an email template generated
+// a parser for text the system had just rendered. `template.output` is outbound
+// only and emits nothing here.
 //
 // Consumer wiring (metaobjects.config.ts):
 //   generators: [..., promptRender(), outputParser()]
 //
 // Custom output directory:
 //   generators: [..., outputParser({ outDir: "src/generated/outputs" })]
-import { TEMPLATE_SUBTYPE_OUTPUT } from "@metaobjectsdev/metadata";
-import { findTemplates } from "../templates/find-templates.js";
+import { inboundTemplates } from "../templates/find-inbound.js";
 import { oncePerRun, } from "../generator.js";
 import { renderOutputParser } from "../templates/output-parser.js";
 export const outputParser = function outputParser(opts) {
@@ -17,11 +22,11 @@ export const outputParser = function outputParser(opts) {
     const generator = {
         name: "output-parser",
         generate: oncePerRun((_entities, ctx) => {
-            const outputs = findTemplates(ctx.loadedRoot, TEMPLATE_SUBTYPE_OUTPUT);
+            const responders = inboundTemplates(ctx.loadedRoot);
             const files = [];
-            for (const t of outputs) {
+            for (const t of responders) {
                 files.push({
-                    path: `${dirPrefix}${t.name}.output.ts`,
+                    path: `${dirPrefix}${t.name}.response.ts`,
                     // ADR-0044/#228: thread ctx.renderContext (when present — runGen always supplies it;
                     // a hand-rolled GenContext in a unit test may omit it, falling back to bare naming) so
                     // a payload/nested value-object whose bare name collides across packages emits the

package/dist/generators/output-parser-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"output-parser-file.js","sourceRoot":"","sources":["../../src/generators/output-parser-file.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,4EAA4E;AAC5E,oFAAoF;AACpF,EAAE;AACF,2CAA2C;AAC3C,sDAAsD;AACtD,EAAE;AACF,2BAA2B;AAC3B,yEAAyE;AAEzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAIL,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AASnE,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,YAAY,CAAC,IAAuB;IACvE,MAAM,SAAS,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE;YACtC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;YACvE,MAAM,KAAK,GAAkB,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,YAAY;oBACvC,qFAAqF;oBACrF,uFAAuF;oBACvF,mFAAmF;oBACnF,iFAAiF;oBACjF,yCAAyC;oBACzC,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC;iBACvE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;KACH,CAAC;IACF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAuC,CAAC"}
+{"version":3,"file":"output-parser-file.js","sourceRoot":"","sources":["../../src/generators/output-parser-file.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,8BAA8B;AAC9B,EAAE;AACF,+EAA+E;AAC/E,kFAAkF;AAClF,gFAAgF;AAChF,+BAA+B;AAC/B,EAAE;AACF,2CAA2C;AAC3C,sDAAsD;AACtD,EAAE;AACF,2BAA2B;AAC3B,yEAAyE;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAIL,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AASnE,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,YAAY,CAAC,IAAuB;IACvE,MAAM,SAAS,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE;YACtC,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACpD,MAAM,KAAK,GAAkB,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,cAAc;oBACzC,qFAAqF;oBACrF,uFAAuF;oBACvF,mFAAmF;oBACnF,iFAAiF;oBACjF,yCAAyC;oBACzC,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC;iBACvE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;KACH,CAAC;IACF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAuC,CAAC"}

package/dist/generators/output-prompt-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-prompt-file.d.ts","sourceRoot":"","sources":["../../src/generators/output-prompt-file.ts"],"names":[],"mappings":"AAoBA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,YAAY,EAiCpB,gBAAgB,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"output-prompt-file.d.ts","sourceRoot":"","sources":["../../src/generators/output-prompt-file.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAIzB,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,YAAY,EAsBpB,gBAAgB,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/generators/output-prompt-file.js

@@ -1,45 +1,35 @@
 // server/typescript/packages/codegen-ts/src/generators/output-prompt-file.ts
 //
-// FR-010 stock generator that emits one <TemplateName>.prompt.ts file per json/xml
-// template.output node — the output-format prompt fragment ("produce your answer
-// like this"). Wraps renderOutputPrompt() from templates/output-prompt.ts. Skips
-// text-format outputs and outputs whose @payloadRef doesn't resolve to a value-object
-// (same contract as the output-parser generator).
+// FR-010 stock generator that emits one <PromptName>.responseFormat.ts file per
+// responding `template.prompt` — the response-format fragment ("produce your answer
+// like this"). Wraps renderOutputPrompt() from templates/output-prompt.ts.
+//
+// ADR-0052: gated on `@responseRef` presence, like every other inbound generator.
+// It previously keyed on `template.output` + a json/xml `@format` gate, which is
+// how a fragment that instructs an LLM came to be emitted from the subtype defined
+// as "every rendered artifact other than an LLM prompt".
 //
 // Consumer wiring (metaobjects.config.ts):
 //   generators: [..., promptRender(), outputParser(), outputPrompt()]
 //
 // Custom output directory:
 //   generators: [..., outputPrompt({ outDir: "src/generated/outputs" })]
-import { TYPE_TEMPLATE, TEMPLATE_SUBTYPE_OUTPUT, TEMPLATE_ATTR_PAYLOAD_REF, resolveObjectRef, } from "@metaobjectsdev/metadata";
 import { oncePerRun, } from "../generator.js";
-import { renderOutputPrompt, templateSupportsPrompt } from "../templates/output-prompt.js";
+import { inboundTemplates, responseShape } from "../templates/find-inbound.js";
+import { renderOutputPrompt } from "../templates/output-prompt.js";
 export const outputPrompt = function outputPrompt(opts) {
     const dirPrefix = opts?.outDir ? `${opts.outDir.replace(/\/$/, "")}/` : "";
     const generator = {
         name: "output-prompt",
         generate: oncePerRun((_entities, ctx) => {
             const root = ctx.loadedRoot;
-            // ADR-0039: resolving — root has no super (children()==ownChildren()).
-            const outputs = root
-                .children()
-                .filter((c) => c.type === TYPE_TEMPLATE && c.subType === TEMPLATE_SUBTYPE_OUTPUT);
             const files = [];
-            for (const t of outputs) {
-                // Only json/xml outputs get a renderable prompt fragment.
-                if (!templateSupportsPrompt(t))
-                    continue;
-                // @payloadRef must resolve to a value-object (same contract as the parser).
-                // ADR-0039: resolving — a template may inherit its @* refs/format/kind via extends.
-                const payloadRef = t.attr(TEMPLATE_ATTR_PAYLOAD_REF);
-                if (typeof payloadRef !== "string")
-                    continue;
-                // ADR-0042: a bare @payloadRef resolves in the template's package.
-                const vo = resolveObjectRef(root, payloadRef, t.package ?? t.fileDefaultPackage ?? "").node;
-                if (!vo)
+            for (const t of inboundTemplates(root)) {
+                // @responseRef must resolve to a value-object (same contract as the parser).
+                if (!responseShape(root, t))
                     continue;
                 files.push({
-                    path: `${dirPrefix}${t.name}.prompt.ts`,
+                    path: `${dirPrefix}${t.name}.responseFormat.ts`,
                     content: renderOutputPrompt(root, t.name),
                 });
             }

package/dist/generators/output-prompt-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"output-prompt-file.js","sourceRoot":"","sources":["../../src/generators/output-prompt-file.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,mFAAmF;AACnF,iFAAiF;AACjF,iFAAiF;AACjF,sFAAsF;AACtF,kDAAkD;AAClD,EAAE;AACF,2CAA2C;AAC3C,sEAAsE;AACtE,EAAE;AACF,2BAA2B;AAC3B,yEAAyE;AAEzE,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAIL,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAS3F,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,YAAY,CAAC,IAAuB;IACvE,MAAM,SAAS,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE;YACtC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC;YAC5B,uEAAuE;YACvE,MAAM,OAAO,GAAG,IAAI;iBACjB,QAAQ,EAAE;iBACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,OAAO,KAAK,uBAAuB,CAAC,CAAC;YACpF,MAAM,KAAK,GAAkB,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,0DAA0D;gBAC1D,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;oBAAE,SAAS;gBACzC,4EAA4E;gBAC5E,oFAAoF;gBACpF,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;gBACrD,IAAI,OAAO,UAAU,KAAK,QAAQ;oBAAE,SAAS;gBAC7C,mEAAmE;gBACnE,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;gBAC5F,IAAI,CAAC,EAAE;oBAAE,SAAS;gBAClB,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,YAAY;oBACvC,OAAO,EAAE,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;iBAC1C,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;KACH,CAAC;IACF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAuC,CAAC"}
+{"version":3,"file":"output-prompt-file.js","sourceRoot":"","sources":["../../src/generators/output-prompt-file.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,gFAAgF;AAChF,oFAAoF;AACpF,2EAA2E;AAC3E,EAAE;AACF,kFAAkF;AAClF,iFAAiF;AACjF,mFAAmF;AACnF,yDAAyD;AACzD,EAAE;AACF,2CAA2C;AAC3C,sEAAsE;AACtE,EAAE;AACF,2BAA2B;AAC3B,yEAAyE;AAEzE,OAAO,EAIL,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AASnE,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,YAAY,CAAC,IAAuB;IACvE,MAAM,SAAS,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE;YACtC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC;YAC5B,MAAM,KAAK,GAAkB,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,6EAA6E;gBAC7E,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;oBAAE,SAAS;gBACtC,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,oBAAoB;oBAC/C,OAAO,EAAE,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;iBAC1C,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;KACH,CAAC;IACF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAuC,CAAC"}

package/dist/generators/requirement-tests.d.ts

@@ -0,0 +1,44 @@
+import type { Generator } from "../generator.js";
+import { type RequirementView } from "../requirement-walk.js";
+import { type RequirementTestArgs } from "../templates/requirement-test.js";
+export type RequirementTestRenderer = (a: RequirementTestArgs) => string;
+export interface RequirementTestsOpts {
+    /** Generator name — surfaces in diagnostics and drift logs. */
+    name?: string;
+    /** WHICH requirements get stubs. This is the app's policy declaration. */
+    filter?: (r: RequirementView) => boolean;
+    /** Renderer per concern key: exact `type.subType`, `type.*`, or `*`. */
+    renderers?: Record<string, RequirementTestRenderer>;
+    /** Full control over renderer selection — beats `renderers` when it returns one. */
+    resolveRenderer?: (concern: string) => RequirementTestRenderer | undefined;
+    /** Where each stub lands. */
+    path?: (view: RequirementView, concern: string) => string;
+    /** Named output target (registry key). */
+    target?: string;
+    /** Name requirements no filter covered. Default true; never fails the build. */
+    warnUncovered?: boolean;
+    /**
+     * FR-038 §8 — which emitted paths this generator is the sole producer of, so
+     * the runner may remove a stub whose requirement was deleted. Given a path
+     * relative to this generator's output directory, `/`-separated.
+     *
+     * Defaults to the namespace `defaultPath` writes into. Supply this whenever you
+     * supply `path`: the two describe the same namespace from opposite directions
+     * and only you can keep them in agreement.
+     */
+    owns?: (relPathInTarget: string) => boolean;
+    /**
+     * Delete a hand-edited orphan rather than refusing it. Default false.
+     *
+     * A refusal already names the file and tells you the two ways out; this makes
+     * the destructive one automatic. It exists so the decision is yours, not
+     * because it is a good default.
+     */
+    forceOrphanDelete?: boolean;
+    /** Turn orphan reconciliation off entirely. Default true — a stub whose
+     *  requirement is gone is drift, and leaving it is how a deleted claim keeps a
+     *  green test. */
+    reconcileOrphans?: boolean;
+}
+export declare function requirementTests(opts?: RequirementTestsOpts): Generator;
+//# sourceMappingURL=requirement-tests.d.ts.map

package/dist/generators/requirement-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-tests.d.ts","sourceRoot":"","sources":["../../src/generators/requirement-tests.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAA2B,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,EAAE,mBAAmB,KAAK,MAAM,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC;IACzC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACpD,oFAAoF;IACpF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,uBAAuB,GAAG,SAAS,CAAC;IAC3E,6BAA6B;IAC7B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1D,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;sBAEkB;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AA4CD,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,oBAAyB,GAAG,SAAS,CAoF3E"}

package/dist/generators/requirement-tests.js

@@ -0,0 +1,127 @@
+// FR-038 §5/§6 — generate test stubs from `requirement.*` nodes.
+//
+// THE DIVISION OF LABOUR: this package owns the MECHANISM; the application owns
+// the POLICY. Which requirements get tests, at which levels, in what style, or
+// none at all, is the app's decision — the library ships defaults and
+// recommendations, never rules.
+//
+// The filter IS the policy declaration, which is why there is no opt-out
+// vocabulary: a requirement matched by no generator expects no stub by
+// construction, so `verify --codegen` has nothing to drift against. An `@noTest`
+// attribute would have to clear ADR-0023's can't-be-computed bar, and it cannot —
+// the generator config already says it.
+//
+// Every default below has an override seam. The rule: if an application can hit a
+// decision and cannot change it, that decision becomes a bug report against this
+// package.
+import { REQUIREMENT_SUBTYPE_FUNCTIONAL, REQUIREMENT_LINK_FLOOR_LEVEL, REQUIREMENT_ATTR_STATEMENT, REQUIREMENT_ATTR_COUNTEREXAMPLE, } from "@metaobjectsdev/metadata";
+import { walkRequirements, groupByConcern, NO_CONCERN, } from "../requirement-walk.js";
+import { renderRequirementTest, } from "../templates/requirement-test.js";
+/** How many uncovered requirements to name before "…and N more". Mirrors the
+ *  runner's MAX_NAMED — the same cutoff, so every wall-avoiding message in the
+ *  feature reads the same shape. */
+const MAX_NAMED_UNCOVERED = 5;
+/** The directory `defaultPath` writes into — and therefore the namespace the
+ *  default policy claims. Kept beside it so the pair cannot drift. */
+const DEFAULT_STUB_DIR = "requirements/";
+/**
+ * RECOMMENDATION, not a rule: functional requirements at or below the link floor.
+ *
+ * Architectural requirements are excluded by default because `verify`'s
+ * universality check already proves them structurally, so a test there is usually
+ * redundant — usually, not never, which is exactly why this is overridable.
+ */
+const defaultFilter = (r) => r.subType === REQUIREMENT_SUBTYPE_FUNCTIONAL &&
+    (r.level ?? 0) >= REQUIREMENT_LINK_FLOOR_LEVEL;
+const defaultPath = (view, concern) => concern === NO_CONCERN
+    ? `${DEFAULT_STUB_DIR}${view.path}.test.ts`
+    : `${DEFAULT_STUB_DIR}${view.path}.${concern}.test.ts`;
+/** Exact concern → `type.*` → `*` → the built-in renderer. */
+function pickRenderer(concern, opts) {
+    const viaFn = opts.resolveRenderer?.(concern);
+    if (viaFn !== undefined)
+        return viaFn;
+    const map = opts.renderers ?? {};
+    const typeOnly = `${concern.split(".")[0] ?? ""}.*`;
+    return map[concern] ?? map[typeOnly] ?? map[NO_CONCERN] ?? renderRequirementTest;
+}
+function attrString(node, name) {
+    const v = node.attr(name);
+    return typeof v === "string" ? v : "";
+}
+export function requirementTests(opts = {}) {
+    const filter = opts.filter ?? defaultFilter;
+    const toPath = opts.path ?? defaultPath;
+    // A custom `path` with no custom `owns` leaves the default namespace pointing
+    // somewhere the generator no longer writes, so reconciliation matches nothing.
+    // That degrades safely — it can only ever delete less — but silently, and a
+    // policy nobody can tell isn't running is the failure mode §5 is about.
+    const namespaceUnknown = opts.path !== undefined && opts.owns === undefined;
+    const generator = {
+        name: opts.name ?? "requirement-tests",
+        generate: (ctx) => {
+            const files = [];
+            const uncovered = [];
+            if (namespaceUnknown && opts.reconcileOrphans !== false) {
+                ctx.warn(`a custom 'path' was supplied without a matching 'owns', so a stub left ` +
+                    `behind by a deleted requirement will NOT be cleaned up. Supply 'owns' ` +
+                    `to describe where 'path' writes, or set reconcileOrphans: false.`);
+            }
+            for (const walked of walkRequirements(ctx.loadedRoot)) {
+                if (!filter(walked.view)) {
+                    uncovered.push(walked.view.path);
+                    continue;
+                }
+                for (const [concern, targets] of groupByConcern(walked)) {
+                    const args = {
+                        view: walked.view,
+                        concern,
+                        targets,
+                        statement: attrString(walked.node, REQUIREMENT_ATTR_STATEMENT),
+                        counterexample: attrString(walked.node, REQUIREMENT_ATTR_COUNTEREXAMPLE),
+                        disposition: walked.node.disposition(),
+                        trackedBy: walked.node.trackedBy(),
+                    };
+                    files.push({
+                        path: toPath(walked.view, concern),
+                        content: pickRenderer(concern, opts)(args),
+                    });
+                }
+            }
+            // Policy living only in config means an uncovered requirement is
+            // indistinguishable from a deliberate exclusion. One warning, never failing,
+            // so "no tests here" is a visible choice rather than silence.
+            if ((opts.warnUncovered ?? true) && uncovered.length > 0) {
+                // CAPPED, matching the runner's refusal message. The default filter excludes
+                // every architectural node and every L1-L3 functional one, so on the ledger
+                // shapes this repo's own docs describe — dozens to hundreds of entries — an
+                // uncapped list is a wall of dotted paths with the one actionable sentence
+                // buried at the end of it. This is a generator meant to be the feature's first
+                // contact; burying the opt-out is how it gets switched off wholesale.
+                const shown = uncovered.slice(0, MAX_NAMED_UNCOVERED).join(", ");
+                const more = uncovered.length > MAX_NAMED_UNCOVERED
+                    ? `, and ${uncovered.length - MAX_NAMED_UNCOVERED} more`
+                    : "";
+                ctx.warn(`${uncovered.length} requirement(s) matched no filter and get no stub. ` +
+                    `If that is deliberate, set warnUncovered: false to silence this. ` +
+                    `Uncovered: ${shown}${more}.`);
+            }
+            return files;
+        },
+    };
+    if (opts.target !== undefined)
+        generator.target = opts.target;
+    if (opts.reconcileOrphans !== false) {
+        generator.orphanPolicy = {
+            // With a custom `path` and no `owns`, claim NOTHING rather than guess: the
+            // default namespace would be a claim over a directory this generator does
+            // not write to, and a wrong claim deletes another generator's files.
+            owns: opts.owns ?? (namespaceUnknown
+                ? () => false
+                : (relPath) => relPath.startsWith(DEFAULT_STUB_DIR)),
+            ...(opts.forceOrphanDelete === true && { force: true }),
+        };
+    }
+    return generator;
+}
+//# sourceMappingURL=requirement-tests.js.map

package/dist/generators/requirement-tests.js.map

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

package/dist/generators/requirements-file.d.ts

@@ -0,0 +1,9 @@
+import { type GeneratorFactory } from "../generator.js";
+export interface RequirementsFileOpts {
+    /** Output directory prefix relative to the target's outDir. Default: "" (root). */
+    outDir?: string;
+    /** Optional named output target (registry key). Defaults to "default". */
+    target?: string;
+}
+export declare const requirementsFile: GeneratorFactory<RequirementsFileOpts>;
+//# sourceMappingURL=requirements-file.d.ts.map

package/dist/generators/requirements-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements-file.d.ts","sourceRoot":"","sources":["../../src/generators/requirements-file.ts"],"names":[],"mappings":"AAsBA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAUzB,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,gBAAgB,EA0BxB,gBAAgB,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/generators/requirements-file.js

@@ -0,0 +1,53 @@
+// server/typescript/packages/codegen-ts/src/generators/requirements-file.ts
+//
+// The `requirements` docs surface generator — emits the ledger as documentation.
+//
+// Design: docs/superpowers/specs/2026-08-21-requirements-doc-surface-design.md
+//
+// METADATA ALONE. `meta docs` guarantees output "from metadata ALONE — no gen config, no
+// codegen pipeline" (cli/src/commands/docs.ts). This generator reads `ctx.loadedRoot` and
+// NOTHING else — no filesystem walk, no config read, no test-source scan. That sentence
+// is what rules out reviving the retired `@verifiedBy` scan here, and it only keeps being
+// true if nobody adds a second input.
+//
+// AN EMPTY LEDGER EMITS ZERO FILES, not an empty page. That is a contract with the
+// surface wiring, not a cosmetic choice: `requirements` defaults to ON, and this is the
+// only reason that is a no-op for every project without a ledger.
+//
+// BOTH FILES, UNCONDITIONALLY — deliberately not behind a `--format` flag. `meta docs`
+// writes FILES, while `--format` on gen/migrate selects a STDOUT encoding; reusing the
+// name would make it mean something materially different on this command. A drift gate
+// also wants the machine-readable artifact committed regardless of who ran it or from
+// what kind of terminal.
+import { oncePerRun, } from "../generator.js";
+import { renderRequirementsMarkdown } from "./requirements-markdown.js";
+import { renderRequirementsToon } from "./requirements-toon.js";
+import { requirementRows } from "./requirements-view.js";
+/** The human-facing index. */
+const MARKDOWN_FILENAME = "requirements.md";
+/** The machine-facing artifact — see requirements-toon.ts for why TOON. */
+const TOON_FILENAME = "requirements.toon";
+export const requirementsFile = function requirementsFile(opts) {
+    const dirPrefix = opts?.outDir ? `${opts.outDir.replace(/\/$/, "")}/` : "";
+    const generator = {
+        name: "requirements-file",
+        generate: oncePerRun((_entities, ctx) => {
+            const rows = requirementRows(ctx.loadedRoot);
+            // The one early return that matters. Both renderers also return "" for an empty
+            // ledger, so this is belt-and-braces — but the guarantee callers depend on is
+            // "zero FILES", which only this line can provide.
+            if (rows.length === 0)
+                return [];
+            const files = [
+                { path: `${dirPrefix}${MARKDOWN_FILENAME}`, content: renderRequirementsMarkdown(rows) },
+                { path: `${dirPrefix}${TOON_FILENAME}`, content: renderRequirementsToon(rows) },
+            ];
+            return files;
+        }),
+    };
+    if (opts?.target) {
+        generator.target = opts.target;
+    }
+    return generator;
+};
+//# sourceMappingURL=requirements-file.js.map

package/dist/generators/requirements-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements-file.js","sourceRoot":"","sources":["../../src/generators/requirements-file.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,iFAAiF;AACjF,EAAE;AACF,+EAA+E;AAC/E,EAAE;AACF,yFAAyF;AACzF,0FAA0F;AAC1F,wFAAwF;AACxF,0FAA0F;AAC1F,sCAAsC;AACtC,EAAE;AACF,mFAAmF;AACnF,wFAAwF;AACxF,kEAAkE;AAClE,EAAE;AACF,uFAAuF;AACvF,uFAAuF;AACvF,uFAAuF;AACvF,sFAAsF;AACtF,yBAAyB;AAEzB,OAAO,EAIL,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,8BAA8B;AAC9B,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAC5C,2EAA2E;AAC3E,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAS1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,gBAAgB,CACvD,IAA2B;IAE3B,MAAM,SAAS,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE;YACtC,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC7C,gFAAgF;YAChF,8EAA8E;YAC9E,kDAAkD;YAClD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAEjC,MAAM,KAAK,GAAkB;gBAC3B,EAAE,IAAI,EAAE,GAAG,SAAS,GAAG,iBAAiB,EAAE,EAAE,OAAO,EAAE,0BAA0B,CAAC,IAAI,CAAC,EAAE;gBACvF,EAAE,IAAI,EAAE,GAAG,SAAS,GAAG,aAAa,EAAE,EAAE,OAAO,EAAE,sBAAsB,CAAC,IAAI,CAAC,EAAE;aAChF,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;KACH,CAAC;IAEF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAA2C,CAAC"}

package/dist/generators/requirements-markdown.d.ts

@@ -0,0 +1,10 @@
+import type { RequirementRow } from "./requirements-view.js";
+/**
+ * Render the ledger as one markdown index.
+ *
+ * Returns the EMPTY STRING for an empty ledger rather than a headed-but-empty page.
+ * The generator keys on that to emit no file at all, which is in turn what lets the
+ * surface default to on without changing output for any project lacking a ledger.
+ */
+export declare function renderRequirementsMarkdown(rows: readonly RequirementRow[]): string;
+//# sourceMappingURL=requirements-markdown.d.ts.map

package/dist/generators/requirements-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements-markdown.d.ts","sourceRoot":"","sources":["../../src/generators/requirements-markdown.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAmC7D;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAUlF"}