rhachet-roles-ehmpathy 1.4.0 → 1.7.0

package/dist/logic/hooks/execTranslateDocOutputPath.test.js

@@ -0,0 +1,528 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const helpful_errors_1 = require("helpful-errors");
+const test_fns_1 = require("test-fns");
+const execTranslateDocOutputPath_1 = require("./execTranslateDocOutputPath");
+const context = {
+    log: console,
+};
+describe('execTranslateDocOutputPath (integration; hard-coded expectations)', () => {
+    (0, test_fns_1.given)('opts.output is not a string', () => {
+        const input = { output: undefined };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it returns opts unchanged', () => {
+                expect(result).toBe(input);
+            });
+        });
+    });
+    (0, test_fns_1.given)('opts.output is a string but not an @translate(...) call', () => {
+        const input = { output: 'hello.md', references: 'foo' };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it returns opts unchanged', () => {
+                expect(result).toBe(input);
+            });
+        });
+    });
+    (0, test_fns_1.given)('opts.output is @translate(...) but not references.0', () => {
+        const input = {
+            output: '@translate(references.1).as(story)',
+            references: 'src/a.[stories].v1.i2.md',
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const err = (0, test_fns_1.getError)(() => (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context));
+            (0, test_fns_1.then)('it throws a BadRequestError', () => {
+                expect(err).toBeInstanceOf(helpful_errors_1.BadRequestError);
+                expect(err.message).toMatch(/unsupported @translation source/i);
+            });
+        });
+    });
+    (0, test_fns_1.given)('opts.output is @translate(references.0) but missing .as(doctype)', () => {
+        const input = {
+            output: '@translate(references.0)',
+            references: 'src/a.[stories].v1.i2.md',
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const err = (0, test_fns_1.getError)(() => (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context));
+            (0, test_fns_1.then)('it throws an UnexpectedCodePathError', () => {
+                expect(err).toBeInstanceOf(helpful_errors_1.UnexpectedCodePathError);
+                expect(err.message).toMatch(/\.as\(doctype\) was not part of output/i);
+            });
+        });
+    });
+    (0, test_fns_1.given)('opts.references is not a string', () => {
+        const input = {
+            output: '@translate(references.0).as(story)',
+            references: ['not-a-string'],
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const err = (0, test_fns_1.getError)(() => (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context));
+            (0, test_fns_1.then)('it throws a BadRequestError', () => {
+                expect(err).toBeInstanceOf(helpful_errors_1.BadRequestError);
+                expect(err.message).toMatch(/opts\.references is not a string/i);
+            });
+        });
+    });
+    (0, test_fns_1.given)('opts.references is an empty string', () => {
+        const input = {
+            output: '@translate(references.0).as(story)',
+            references: '',
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const err = (0, test_fns_1.getError)(() => (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context));
+            (0, test_fns_1.then)('it throws a BadRequestError', () => {
+                expect(err).toBeInstanceOf(helpful_errors_1.BadRequestError);
+                expect(err.message).toMatch(/opts\.references is not a string/i);
+            });
+        });
+    });
+    (0, test_fns_1.given)('happy path: both variant and instance after the source [doctype]', () => {
+        // note: prefix should drop any trailing dot before composing
+        const source = 'src/product/cooltools/tool.hammer/step_5.stories/step_1.translate/' +
+            'provider.plumber_pete.customer.scene_6.build.persp_pro.v2i3.[stories].v5.i7.md';
+        const input = {
+            output: '@translate(references.0).as(story)',
+            references: `${source},other/ignored.md`,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it preserves vNiN before new [doctype], sets v1 after, and keeps extension', () => {
+                const expectedPrefix = 'src/product/cooltools/tool.hammer/step_5.stories/step_1.translate/' +
+                    'provider.plumber_pete.customer.scene_6.build.persp_pro.v2i3';
+                const expected = `${expectedPrefix}.v5i7.[story].v1.md`;
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('only variant exists after the source [doctype]', () => {
+        const source = 'x/y/z/topic.v9.[notes].v12.md';
+        const input = {
+            output: '@translate(references.0).as(report)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it places vN before [doctype], appends .v1.ext', () => {
+                const expected = 'x/y/z/topic.v9.v12.[report].v1.md';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('only instance exists after the source [doctype]', () => {
+        const source = 'x/y/z/topic.[stories].i8.txt';
+        const input = {
+            output: '@translate(references.0).as(notes)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it places iN before [doctype], appends .v1.ext', () => {
+                const expected = 'x/y/z/topic.i8.[notes].v1.txt';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('no versions exist after the source [doctype]', () => {
+        const source = 'dir/file.[story].md';
+        const input = {
+            output: '@translate(references.0).as(stories)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it emits prefix.[doctype].v1.ext (no vNiN before [doctype])', () => {
+                const expected = 'dir/file.[stories].v1.md';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('no extension present in the source path', () => {
+        const source = 'a/b/c/topic.[stories].v3.i2';
+        const input = {
+            output: '@translate(references.0).as(summary)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it omits the trailing dot/extension', () => {
+                const expected = 'a/b/c/topic.v3i2.[summary].v1';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('a [doctype] earlier in the path should be ignored (must be after last "/")', () => {
+        const source = 'a/b.[draft]/c/topic.v1i2.i3.md'; // no [doctype] after last slash
+        const input = {
+            output: '@translate(references.0).as(story)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const err = (0, test_fns_1.getError)(() => (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context));
+            (0, test_fns_1.then)('it bubbles up the decoder error', () => {
+                expect(err).toBeInstanceOf(helpful_errors_1.BadRequestError);
+                expect(err.message).toMatch(/could not find any \[doctype]/i);
+            });
+        });
+    });
+    (0, test_fns_1.given)('happy path with .ext(json): override source extension', () => {
+        const source = 'src/product/cooltools/tool.hammer/step_5.stories/step_1.translate/' +
+            'provider.plumber_pete.customer.scene_6.build.persp_pro.v2i3.[stories].v5.i7.md';
+        const input = {
+            output: '@translate(references.0).as(story).ext(json)',
+            references: `${source},ignored/also.md`,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it sets the new extension to .json', () => {
+                const expectedPrefix = 'src/product/cooltools/tool.hammer/step_5.stories/step_1.translate/' +
+                    'provider.plumber_pete.customer.scene_6.build.persp_pro.v2i3';
+                const expected = `${expectedPrefix}.v5i7.[story].v1.json`;
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('source has no extension; .ext(md) supplies one after translation', () => {
+        const source = 'a/b/c/topic.[stories].v3.i2';
+        const input = {
+            output: '@translate(references.0).as(summary).ext(md)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it appends .md', () => {
+                const expected = 'a/b/c/topic.v3i2.[summary].v1.md';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('source has an extension; .ext(md) replaces it with .md consistently', () => {
+        const source = 'x/y/z/topic.[stories].i8.txt';
+        const input = {
+            output: '@translate(references.0).as(notes).ext(md)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it replaces .txt with .md', () => {
+                const expected = 'x/y/z/topic.i8.[notes].v1.md';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('only variant exists after [doctype]; .ext(json) still applies .json', () => {
+        const source = 'x/y/z/topic.v9.[notes].v12.md';
+        const input = {
+            output: '@translate(references.0).as(report).ext(json)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it outputs ...[report].v1.json', () => {
+                const expected = 'x/y/z/topic.v9.v12.[report].v1.json';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+});
+describe('execTranslateDocOutputPath .rel(...) (integration; hard-coded expectations)', () => {
+    describe('relative to gitroot', () => {
+        (0, test_fns_1.given)('@gitroot/ prefix re-roots from git repository root preserving only filename', () => {
+            const source = 'src/product/cooltools/tool.hammer/step_1.translate/' +
+                'provider.scene_6.build.persp_pro.v2i3.[stories].v5.i7.md';
+            const input = {
+                output: '@translate(references.0).as(story).rel(@gitroot/output/formatted)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it re-roots from git root under output/formatted', () => {
+                    const expected = 'output/formatted/provider.scene_6.build.persp_pro.v2i3.v5i7.[story].v1.md';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('@gitroot/ with nested target directories', () => {
+            const source = 'pkg/flows/step_3.translate/topic.branch.v9.[notes].v12.md';
+            const input = {
+                output: '@translate(references.0).as(report).rel(@gitroot/artifacts/reports)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it places under artifacts/reports/ from git root', () => {
+                    const expected = 'artifacts/reports/topic.branch.v9.v12.[report].v1.md';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('@gitroot/ with single directory', () => {
+            const source = 'deep/nested/path/topic.[stories].i8.txt';
+            const input = {
+                output: '@translate(references.0).as(notes).rel(@gitroot/dist)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it places directly under dist/ from git root', () => {
+                    const expected = 'dist/topic.i8.[notes].v1.txt';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('combine @gitroot/ .rel(...) with .ext(json)', () => {
+            const source = 'any/path/item.[story].md';
+            const input = {
+                output: '@translate(references.0).as(summary).rel(@gitroot/build/json).ext(json)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it re-roots from git root and applies .json extension', () => {
+                    const expected = 'build/json/item.[summary].v1.json';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('combine @gitroot/ .rel(...) with .v(n)', () => {
+            const source = 'src/flow/step_1.translate/topic.branch.v9.[notes].v12.md';
+            const input = {
+                output: '@translate(references.0).as(report).v(3).rel(@gitroot/output/v3)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it re-roots from git root and uses specified variant', () => {
+                    const expected = 'output/v3/topic.branch.v9.v12.[report].v3.md';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('source without extension + @gitroot/ .rel(...)', () => {
+            const source = 'docs/step.translate/topic.v3i2.[stories]';
+            const input = {
+                output: '@translate(references.0).as(summary).rel(@gitroot/final)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it re-roots and emits no trailing extension', () => {
+                    const expected = 'final/topic.v3i2.[summary].v1';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('@gitroot alone (just @gitroot/)', () => {
+            const source = 'very/deep/nested/path/file.[draft].v2.md';
+            const input = {
+                output: '@translate(references.0).as(final).rel(@gitroot/)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it places file directly at git root', () => {
+                    const expected = 'file.v2.[final].v1.md';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('complex real-world example with deep path and trailing slash', () => {
+            const source = 'src/products/protools/tool.routecal/1.requirements/step_2.draft/' +
+                'provider.plumber_pete.customer.scene_6.v2i3.[stories].v5.i7.md';
+            const input = {
+                output: '@translate(references.0).as(review).ext(json).rel(@gitroot/src/products/protools/tool.routecal/2.architecture/step_1.criteria/.rheview/).v(5)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it re-roots to the specified gitroot path with all modifiers applied', () => {
+                    const expected = 'src/products/protools/tool.routecal/2.architecture/step_1.criteria/.rheview/' +
+                        'provider.plumber_pete.customer.scene_6.v2i3.v5i7.[review].v5.json';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+    });
+    describe('relative to input file', () => {
+        (0, test_fns_1.given)('move from step_1.translate → ../step_2.format (sibling up)', () => {
+            const source = 'src/product/cooltools/tool.hammer/step_1.translate/' +
+                'provider.scene_6.build.persp_pro.v2i3.[stories].v5.i7.md';
+            const input = {
+                output: '@translate(references.0).as(story).rel(../step_2.format)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it re-roots under step_2.format and composes new file path', () => {
+                    const expectedPrefix = 'src/product/cooltools/tool.hammer/step_2.format/' +
+                        'provider.scene_6.build.persp_pro.v2i3';
+                    const expected = `${expectedPrefix}.v5i7.[story].v1.md`;
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('append a child dir via .rel(./drafts)', () => {
+            const source = 'pkg/flows/step_3.translate/topic.branch.v9.[notes].v12.md';
+            const input = {
+                output: '@translate(references.0).as(report).rel(./drafts)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it nests under drafts/', () => {
+                    const expected = 'pkg/flows/step_3.translate/drafts/topic.branch.v9.v12.[report].v1.md';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('pop one directory via .rel(..)', () => {
+            const source = 'a/b/topic.[stories].i8.txt';
+            const input = {
+                output: '@translate(references.0).as(notes).rel(..)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it moves to a/ and composes there', () => {
+                    const expected = 'a/topic.i8.[notes].v1.txt';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('combine .rel(...) with .ext(json)', () => {
+            const source = 'root/x/item.[story].md';
+            const input = {
+                output: '@translate(references.0).as(summary).rel(../y).ext(json)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it re-roots and overrides extension to .json', () => {
+                    const expected = 'root/y/item.[summary].v1.json';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+        (0, test_fns_1.given)('source without extension + .rel(...) keeps no trailing dot unless .ext provided', () => {
+            const source = 'docs/step.translate/topic.v3i2.[stories]';
+            const input = {
+                output: '@translate(references.0).as(summary).rel(../step.out)',
+                references: source,
+            };
+            (0, test_fns_1.when)('executed', () => {
+                const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+                (0, test_fns_1.then)('it emits no trailing extension', () => {
+                    const expected = 'docs/step.out/topic.v3i2.[summary].v1';
+                    expect(result.output).toBe(expected);
+                });
+            });
+        });
+    });
+});
+describe('execTranslateDocOutputPath .v(n) (integration; hard-coded expectations)', () => {
+    (0, test_fns_1.given)('happy path: override starting variant to v2', () => {
+        const source = 'src/product/cooltools/tool.hammer/step_5.stories/step_1.translate/' +
+            'provider.plumber_pete.customer.scene_6.build.persp_pro.v2i3.[stories].v5.i7.md';
+        const input = {
+            output: '@translate(references.0).as(story).v(2)',
+            references: `${source},other/ignored.md`,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it preserves vNiN before [doctype] and sets tail to .v2', () => {
+                const expectedPrefix = 'src/product/cooltools/tool.hammer/step_5.stories/step_1.translate/' +
+                    'provider.plumber_pete.customer.scene_6.build.persp_pro.v2i3';
+                const expected = `${expectedPrefix}.v5i7.[story].v2.md`;
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('only instance exists after source [doctype]; override to v3', () => {
+        const source = 'x/y/z/topic.[stories].i8.txt';
+        const input = {
+            output: '@translate(references.0).as(notes).v(3)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it places iN before [doctype] and appends .v3.ext', () => {
+                const expected = 'x/y/z/topic.i8.[notes].v3.txt';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('no versions exist after source [doctype]; override to v4', () => {
+        const source = 'dir/file.[story].md';
+        const input = {
+            output: '@translate(references.0).as(stories).v(4)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it emits prefix.[doctype].v4.ext', () => {
+                const expected = 'dir/file.[stories].v4.md';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('.v(n) with .ext override and preserved vNiN', () => {
+        const source = 'src/product/cooltools/tool.hammer/step_5.stories/step_1.translate/' +
+            'provider.scene_6.build.persp_pro.v2i3.[stories].v5.i7.md';
+        const input = {
+            output: '@translate(references.0).as(story).v(6).ext(json)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it outputs ...[story].v6.json (and preserves v5i7 before)', () => {
+                const expectedPrefix = 'src/product/cooltools/tool.hammer/step_5.stories/step_1.translate/' +
+                    'provider.scene_6.build.persp_pro.v2i3';
+                const expected = `${expectedPrefix}.v5i7.[story].v6.json`;
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('.v(n) combined with .rel(...)', () => {
+        const source = 'src/flow/step_1.translate/topic.branch.v9.[notes].v12.md';
+        const input = {
+            output: '@translate(references.0).as(report).v(2).rel(../step_2.format)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it re-roots and uses v2 at the tail', () => {
+                const expected = 'src/flow/step_2.format/topic.branch.v9.v12.[report].v2.md';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+    (0, test_fns_1.given)('invalid .v(0) should fail fast', () => {
+        const source = 'x/y/z/topic.[stories].i8.txt';
+        const input = {
+            output: '@translate(references.0).as(notes).v(0)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const err = (0, test_fns_1.getError)(() => (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context));
+            (0, test_fns_1.then)('it throws a BadRequestError about positive integer', () => {
+                expect(err).toBeInstanceOf(helpful_errors_1.BadRequestError);
+                expect(err.message).toMatch(/\.v\(n\) must be a positive integer/i);
+            });
+        });
+    });
+    (0, test_fns_1.given)('absence of .v(n) defaults to .v1 (control)', () => {
+        const source = 'x/y/z/topic.[stories].i8.txt';
+        const input = {
+            output: '@translate(references.0).as(notes)',
+            references: source,
+        };
+        (0, test_fns_1.when)('executed', () => {
+            const result = (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(input, context);
+            (0, test_fns_1.then)('it uses v1 at the tail', () => {
+                const expected = 'x/y/z/topic.i8.[notes].v1.txt';
+                expect(result.output).toBe(expected);
+            });
+        });
+    });
+});
+//# sourceMappingURL=execTranslateDocOutputPath.test.js.map

package/dist/logic/hooks/execTranslateDocOutputPath.test.js.map

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

package/dist/logic/hooks/getInvokeHooks.d.ts

@@ -0,0 +1,2 @@
+import { InvokeHooks } from 'rhachet';
+export declare const getInvokeHooks: () => InvokeHooks;

package/dist/logic/hooks/getInvokeHooks.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvokeHooks = void 0;
+const execTranslateDocOutputPath_1 = require("./execTranslateDocOutputPath");
+const getInvokeHooks = () => ({
+    onInvokeAskInput: [
+        (input) => {
+            console.log('🪝 hook ran!');
+            return input;
+        },
+        (opts) => (0, execTranslateDocOutputPath_1.execTranslateDocOutputPath)(opts, { log: console }), // todo: forward log context
+    ],
+});
+exports.getInvokeHooks = getInvokeHooks;
+//# sourceMappingURL=getInvokeHooks.js.map

package/dist/logic/hooks/getInvokeHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getInvokeHooks.js","sourceRoot":"","sources":["../../../src/logic/hooks/getInvokeHooks.ts"],"names":[],"mappings":";;;AAEA,6EAA0E;AAEnE,MAAM,cAAc,GAAG,GAAgB,EAAE,CAAC,CAAC;IAChD,gBAAgB,EAAE;QAChB,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,uDAA0B,EAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,4BAA4B;KAC3F;CACF,CAAC,CAAC;AARU,QAAA,cAAc,kBAQxB"}

package/dist/logic/hooks/relateDocOutputPath.d.ts

@@ -0,0 +1,11 @@
+/**
+ * .what = computes the relative path, in relation to some relative modifier
+ * .how =
+ *   - path(path/to/file.md) + relation(../) => path/file.md
+ *   - path(path/to/file.md) + relation(../now) => path/now/file.md
+ *   - path(path/to/file.md) + relation(@gitroot/dist) => dist/file.md
+ */
+export declare const relateDocOutputPath: (input: {
+    path: string;
+    relation: string;
+}) => string;