@meza/adr-tools 1.0.12 → 2.0.1

package/dist/lib/opening.test.js

@@ -0,0 +1,81 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { chooseOpenPlan } from './adr.js';
+describe('chooseOpenPlan', () => {
+    afterEach(() => {
+        vi.unstubAllEnvs();
+    });
+    it('returns none when open is false', () => {
+        expect(chooseOpenPlan({ open: false })).toEqual({ type: 'none' });
+    });
+    it('treats open-with as enabling open', () => {
+        expect(chooseOpenPlan({ openWith: 'code --wait' })).toEqual({
+            type: 'app',
+            name: 'code',
+            args: ['--wait']
+        });
+    });
+    it('parses quoted arguments', () => {
+        expect(chooseOpenPlan({ openWith: 'code "arg with space"' })).toEqual({
+            type: 'app',
+            name: 'code',
+            args: ['arg with space']
+        });
+    });
+    it('unescapes quoted arguments', () => {
+        expect(chooseOpenPlan({ openWith: 'code "arg \\"quoted\\""' })).toEqual({
+            type: 'app',
+            name: 'code',
+            args: ['arg "quoted"']
+        });
+    });
+    it('parses single-quoted arguments', () => {
+        expect(chooseOpenPlan({ openWith: "code 'arg with space'" })).toEqual({
+            type: 'app',
+            name: 'code',
+            args: ['arg with space']
+        });
+    });
+    it('returns none when open-with is not parseable', () => {
+        expect(chooseOpenPlan({ openWith: '"' })).toEqual({ type: 'none' });
+    });
+    it('returns none when open-with is whitespace', () => {
+        expect(chooseOpenPlan({ openWith: '   ' })).toEqual({ type: 'none' });
+    });
+    it('returns none when open-with is only quoted whitespace', () => {
+        expect(chooseOpenPlan({ openWith: '"   "' })).toEqual({ type: 'none' });
+    });
+    it('handles quoted empty command', () => {
+        expect(chooseOpenPlan({ openWith: '""', open: true })).toEqual({ type: 'default' });
+    });
+    it('ignores boolean-like editor values', () => {
+        vi.stubEnv('VISUAL', 'true');
+        vi.stubEnv('EDITOR', 'false');
+        expect(chooseOpenPlan({ open: true })).toEqual({ type: 'default' });
+    });
+    it('prefers VISUAL over EDITOR when both are set', () => {
+        vi.stubEnv('VISUAL', 'code');
+        vi.stubEnv('EDITOR', 'vim');
+        expect(chooseOpenPlan({ open: true })).toEqual({ type: 'app', name: 'code', args: [] });
+    });
+    it('uses EDITOR when it is not npm injected', () => {
+        vi.stubEnv('EDITOR', 'vim');
+        vi.stubEnv('npm_execpath', '');
+        vi.stubEnv('npm_config_editor', '');
+        expect(chooseOpenPlan({ open: true })).toEqual({ type: 'app', name: 'vim', args: [] });
+    });
+    it('falls back to default when EDITOR is npm injected', () => {
+        vi.stubEnv('npm_execpath', '/usr/bin/npm');
+        vi.stubEnv('npm_config_editor', 'vi');
+        vi.stubEnv('EDITOR', 'vi');
+        vi.stubEnv('VISUAL', '');
+        expect(chooseOpenPlan({ open: true })).toEqual({ type: 'default' });
+    });
+    it('uses EDITOR when npm_config_editor is different', () => {
+        vi.stubEnv('npm_execpath', '/usr/bin/npm');
+        vi.stubEnv('npm_config_editor', 'code');
+        vi.stubEnv('EDITOR', 'vim');
+        vi.stubEnv('VISUAL', '');
+        expect(chooseOpenPlan({ open: true })).toEqual({ type: 'app', name: 'vim', args: [] });
+    });
+});
+//# sourceMappingURL=opening.test.js.map

package/dist/lib/opening.test.js.map

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

package/dist/lib/prompt.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
-import inquirer from 'inquirer';
 export const askForClarification = async (searchString, matches) => {
+    const { default: inquirer } = await import('inquirer');
     const selection = await inquirer.prompt([
         {
             type: 'list',

package/dist/lib/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"src/","sources":["lib/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,YAAoB,EAAE,OAAiB,EAAE,EAAE;IACnF,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACtC;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,yCAAyC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG;YAC7E,OAAO,EAAE,OAAO;SACjB;KACF,CAAC,CAAC;IACH,OAAO,SAAS,CAAC,MAAM,CAAC;AAC1B,CAAC,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"src/","sources":["lib/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,YAAoB,EAAE,OAAiB,EAAE,EAAE;IACnF,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACtC;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,yCAAyC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG;YAC7E,OAAO,EAAE,OAAO;SACjB;KACF,CAAC,CAAC;IACH,OAAO,SAAS,CAAC,MAAM,CAAC;AAC1B,CAAC,CAAC"}

package/dist/lib/template.test.js

@@ -0,0 +1,62 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('fs/promises', () => ({
+    default: {
+        readFile: vi.fn()
+    }
+}));
+vi.mock('./config.js', () => ({
+    getDir: vi.fn()
+}));
+const mockEnv = (key, value) => {
+    if (value === undefined) {
+        delete process.env[key];
+        return;
+    }
+    process.env[key] = value;
+};
+describe('template', () => {
+    beforeEach(() => {
+        vi.resetModules();
+        vi.mocked(fs.readFile).mockReset();
+        mockEnv('ADR_TEMPLATE', undefined);
+    });
+    afterEach(() => {
+        mockEnv('ADR_TEMPLATE', undefined);
+        vi.restoreAllMocks();
+    });
+    it('uses the explicit template file when provided', async () => {
+        const { template } = await import('./template.js');
+        vi.mocked(fs.readFile).mockResolvedValueOnce('custom');
+        const result = await template('/tmp/custom.md');
+        expect(result).toEqual('custom');
+        expect(fs.readFile).toHaveBeenCalledWith(path.resolve('/tmp/custom.md'), 'utf8');
+    });
+    it('uses ADR_TEMPLATE when set', async () => {
+        const { template } = await import('./template.js');
+        mockEnv('ADR_TEMPLATE', '/tmp/env.md');
+        vi.mocked(fs.readFile).mockResolvedValueOnce('env');
+        const result = await template();
+        expect(result).toEqual('env');
+        expect(fs.readFile).toHaveBeenCalledWith(path.resolve('/tmp/env.md'), 'utf8');
+    });
+    it('uses template from adr directory when available', async () => {
+        const { template } = await import('./template.js');
+        const { getDir } = await import('./config.js');
+        vi.mocked(getDir).mockResolvedValueOnce('/repo/doc/adr');
+        vi.mocked(fs.readFile).mockResolvedValueOnce('repo-template');
+        const result = await template();
+        expect(result).toEqual('repo-template');
+        expect(fs.readFile).toHaveBeenCalledWith(path.join('/repo/doc/adr', 'templates/template.md'), 'utf8');
+    });
+    it('falls back to built-in template when repo template is missing', async () => {
+        const { template } = await import('./template.js');
+        const { getDir } = await import('./config.js');
+        vi.mocked(getDir).mockResolvedValueOnce('/repo/doc/adr');
+        vi.mocked(fs.readFile).mockRejectedValueOnce(new Error('missing')).mockResolvedValueOnce('built-in');
+        const result = await template();
+        expect(result).toEqual('built-in');
+    });
+});
+//# sourceMappingURL=template.test.js.map

package/dist/lib/template.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.test.js","sourceRoot":"src/","sources":["lib/template.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5B,OAAO,EAAE;QACP,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;KAClB;CACF,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5B,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;CAChB,CAAC,CAAC,CAAC;AAEJ,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,KAAyB,EAAE,EAAE;IACzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAC3B,CAAC,CAAC;AAEF,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,YAAY,EAAE,CAAC;QAClB,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACnC,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACnD,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACnD,OAAO,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QACvC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC/C,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QACzD,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC;IACxG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC/C,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QACzD,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAErG,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -1,3 +1,28 @@
 #!/usr/bin/env node
+import fs from 'node:fs/promises';
+import { Command } from 'commander';
+import { generateToc, init, link, listAdrs, newAdr } from './lib/adr.js';
+import { workingDir } from './lib/config.js';
+import { getLinksFrom, getTitleFrom } from './lib/manipulator.js';
+type ProgramDeps = {
+    generateToc: typeof generateToc;
+    init: typeof init;
+    link: typeof link;
+    listAdrs: typeof listAdrs;
+    newAdr: typeof newAdr;
+    workingDir: typeof workingDir;
+    readFile: typeof fs.readFile;
+    getLinksFrom: typeof getLinksFrom;
+    getTitleFrom: typeof getTitleFrom;
+    version: string;
+    onError: (program: Command, error: Error) => void;
+    log: (message: string) => void;
+    warn: (message: string) => void;
+};
+export declare const defaultOnError: (program: Command, error: Error) => never;
+export declare const buildProgram: (deps?: ProgramDeps) => Command;
+export declare const run: (argv?: string[], deps?: ProgramDeps) => Promise<Command>;
+export declare const isDirectRun: (argv?: string[], moduleUrl?: string) => boolean;
+export declare const maybeRun: (argv?: string[], deps?: ProgramDeps) => boolean;
 export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"src/","sources":["index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"src/","sources":["index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAalE,KAAK,WAAW,GAAG;IACjB,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC;IAC7B,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,EAAE,OAAO,KAAK,UAE5D,CAAC;AAwGF,eAAO,MAAM,YAAY,GAAI,OAAM,WAAyB,YA4F3D,CAAC;AAEF,eAAO,MAAM,GAAG,GAAU,eAAmB,EAAE,OAAM,WAAyB,qBAI7E,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,eAAmB,EAAE,kBAA2B,YAK3E,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,eAAmB,EAAE,OAAO,WAAW,YAO/D,CAAC"}

package/dist/types/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/types/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"src/","sources":["index.test.ts"],"names":[],"mappings":""}

package/dist/types/inject-version.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inject-version.test.d.ts.map

package/dist/types/inject-version.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-version.test.d.ts","sourceRoot":"src/","sources":["inject-version.test.ts"],"names":[],"mappings":""}

package/dist/types/lib/adr.d.ts

@@ -1,9 +1,24 @@
+type OpenPlan = {
+    type: 'none';
+} | {
+    type: 'default';
+} | {
+    type: 'app';
+    name: string;
+    args: string[];
+};
+export declare const chooseOpenPlan: (options?: {
+    open?: boolean;
+    openWith?: string;
+}) => OpenPlan;
 interface NewOptions {
     supersedes?: string[];
     date?: string | undefined;
     suppressPrompts?: boolean;
     template?: string;
     links?: string[];
+    open?: boolean;
+    openWith?: string;
 }
 export declare const generateToc: (options?: {
     prefix?: string;

package/dist/types/lib/adr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adr.d.ts","sourceRoot":"src/","sources":["lib/adr.ts"],"names":[],"mappings":"AAaA,UAAU,UAAU;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AA6GD,eAAO,MAAM,WAAW,GAAU,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,kBAc9D,CAAC;AAEF,eAAO,MAAM,MAAM,GAAU,OAAO,MAAM,EAAE,SAAS,UAAU,kBAuC9D,CAAC;AAEF,eAAO,MAAM,IAAI,GAAU,YAAY,MAAM,kBAQ5C,CAAC;AAEF,eAAO,MAAM,IAAI,GACf,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,UAAU;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,kBAqB9B,CAAC;AAEF,eAAO,MAAM,QAAQ,yBAapB,CAAC"}
+{"version":3,"file":"adr.d.ts","sourceRoot":"src/","sources":["lib/adr.ts"],"names":[],"mappings":"AAuEA,KAAK,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAsEvG,eAAO,MAAM,cAAc,GAAI,UAAU;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,QAyBhF,CAAC;AAEF,UAAU,UAAU;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA2GD,eAAO,MAAM,WAAW,GAAU,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,kBAc9D,CAAC;AAEF,eAAO,MAAM,MAAM,GAAU,OAAO,MAAM,EAAE,SAAS,UAAU,kBAyB9D,CAAC;AAEF,eAAO,MAAM,IAAI,GAAU,YAAY,MAAM,kBAQ5C,CAAC;AAEF,eAAO,MAAM,IAAI,GACf,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,UAAU;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,kBAqB9B,CAAC;AAEF,eAAO,MAAM,QAAQ,yBAkBpB,CAAC"}

package/dist/types/lib/adr.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adr.test.d.ts.map

package/dist/types/lib/adr.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.test.d.ts","sourceRoot":"src/","sources":["lib/adr.test.ts"],"names":[],"mappings":""}

package/dist/types/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"src/","sources":["lib/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,cAAsB,CAAC;AAyB9C,eAAO,MAAM,MAAM,QAAa,OAAO,CAAC,MAAM,CAI7C,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"src/","sources":["lib/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,cAAsB,CAAC;AA0B9C,eAAO,MAAM,MAAM,QAAa,OAAO,CAAC,MAAM,CAI7C,CAAC"}

package/dist/types/lib/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/types/lib/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"src/","sources":["lib/config.test.ts"],"names":[],"mappings":""}

package/dist/types/lib/manipulator-errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manipulator-errors.test.d.ts.map

package/dist/types/lib/manipulator-errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manipulator-errors.test.d.ts","sourceRoot":"src/","sources":["lib/manipulator-errors.test.ts"],"names":[],"mappings":""}

package/dist/types/lib/opening.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=opening.test.d.ts.map

package/dist/types/lib/opening.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening.test.d.ts","sourceRoot":"src/","sources":["lib/opening.test.ts"],"names":[],"mappings":""}

package/dist/types/lib/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"src/","sources":["lib/prompt.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,GAAU,cAAc,MAAM,EAAE,SAAS,MAAM,EAAE,iBAUhF,CAAC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"src/","sources":["lib/prompt.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,GAAU,cAAc,MAAM,EAAE,SAAS,MAAM,EAAE,iBAWhF,CAAC"}

package/dist/types/lib/template.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=template.test.d.ts.map

package/dist/types/lib/template.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.test.d.ts","sourceRoot":"src/","sources":["lib/template.test.ts"],"names":[],"mappings":""}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const LIB_VERSION = "1.0.12";
+export declare const LIB_VERSION = "2.0.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/types/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"src/","sources":["version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"src/","sources":["version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/version.js

@@ -1,2 +1,2 @@
-export const LIB_VERSION = '1.0.12';
+export const LIB_VERSION = '2.0.1';
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"src/","sources":["version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"src/","sources":["version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/doc/adr/.adr-sequence.lock

@@ -1 +1 @@
-1
+4

package/doc/adr/0001-record-architecture-decisions.md

@@ -0,0 +1,21 @@
+# 1. Record architecture decisions
+
+Date: 2022-06-22
+
+## Status
+
+Accepted
+
+## Context
+
+We need to record the architectural decisions made on this project.
+
+## Decision
+
+We will use Architecture Decision Records, as [described by Michael Nygard](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions).
+
+## Consequences
+
+See Michael Nygard's article, linked above.
+For a lightweight ADR toolset, see Nat Pryce's [adr-tools](https://github.com/npryce/adr-tools).
+> For a node version of the same tooling, see Meza's [adr-tools](https://github.com/meza/adr-tools).

package/doc/adr/0002-using-heavy-e2e-tests.md

@@ -0,0 +1,20 @@
+# 2. Using Heavy E2E Tests
+
+Date: 2022-06-22
+
+## Status
+
+Accepted
+
+## Context
+
+The original tool has an [exhaustive test suite](https://github.com/npryce/adr-tools/tree/master/tests) that allows us to make sure that we're backwards compatible.
+
+## Decision
+
+We'll be re-implementing those tests for ourselves too. This means that we will be using the original examples,
+expectations and the ethos of invoking the tool with the given examples.
+
+## Consequences
+
+The E2E test suite will be very slow to run and it can only be executed sequentially.

package/doc/adr/0003-esm.md

@@ -0,0 +1,34 @@
+# 3. ESM
+
+Date: 2022-06-29
+
+## Status
+
+Accepted
+
+## Context
+
+With typescript 4.7 come proper ESM modules.
+
+ECMAScript modules are the official standard format to package JavaScript code for reuse. Modules are defined using a variety of import and export statements.
+
+## Decision
+
+Since this is a new project, there's no reason to _not_ go with the flow.
+
+## Consequences
+
+There's some changes to the way the project is set up.
+Everything is described here, in [Typescript's official documentation](https://devblogs.microsoft.com/typescript/announcing-typescript-4-7-beta/#ecmascript-module-support-in-node-js)
+
+However, some highlights:
+
+We **must** import code with extensions and `.js` at that (even though the file's actual type is .ts)
+
+`__dirname` and `__filename` are no longer available. Use this instead:
+```typescript
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);```

package/doc/adr/0004-gate-editor-opening-behind---open-and---open-with.md

@@ -0,0 +1,55 @@
+# 4. Gate editor opening behind --open and --open-with
+
+Date: 2026-01-04
+
+## Status
+
+Accepted
+
+## Context
+
+This tool historically tries to open a newly created ADR in the user's editor by reading the `VISUAL` and `EDITOR`
+environment variables.
+
+In 2025, a common way to run Node CLIs is via `npx`/`npm exec`. npm injects an `EDITOR` value into child processes
+based on npm config (`npm_config_editor`), even when the user did not intend to configure an editor for this tool.
+
+This creates two classes of problems:
+
+1. Unwanted side effects. Creating an ADR can unexpectedly launch an editor or attempt to launch a placeholder value.
+2. Cross-platform friction. Windows shells, quoting rules, and editor invocation are inconsistent, making the default
+   "auto open" behavior more fragile than the rest of the CLI.
+
+We still want a good "create and open" workflow, but it must be explicit and predictable, and it must work well on
+Windows, macOS, and Linux.
+
+## Decision
+
+We will stop automatically opening an editor after `adr new` by default.
+
+We will add two flags to the CLI:
+
+- `--open`: Open the newly created ADR file after creation.
+- `--open-with <command>`: Open the newly created ADR file using the provided command (optionally including args).
+
+When `--open` is supplied, the tool will select an opener in this order:
+
+1. `--open-with <command>` if provided.
+2. `VISUAL` if it is set by the user and not empty.
+3. `EDITOR` if it is set by the user and not empty.
+4. OS default application for the file type.
+
+To handle cross-platform differences, we will use a dedicated dependency (`open`) to perform the actual launching
+when possible, rather than building platform-specific process spawning logic in this project.
+
+## Consequences
+
+This makes ADR creation deterministic and side-effect free by default, including when invoked via `npx` or within CI.
+
+Users who want the "open after create" workflow can still have it, but must opt in via `--open` or explicitly specify
+an opener via `--open-with`.
+
+This reduces platform-specific bugs and maintenance burden by relying on a well-maintained cross-platform opener.
+
+This is a breaking behavior change for users who relied on implicit editor opening when `VISUAL`/`EDITOR` were set,
+but the new behavior is more predictable and better aligned with modern Node execution environments.

package/doc/adr/decisions.md

@@ -1,3 +1,6 @@
 # Table of Contents
 
-- [1. Something about Node.JS](0001-something-about-node-js.md)
+- [1. Record architecture decisions](0001-record-architecture-decisions.md)
+- [2. Using Heavy E2E Tests](0002-using-heavy-e2e-tests.md)
+- [3. ESM](0003-esm.md)
+- [4. Gate editor opening behind --open and --open-with](0004-gate-editor-opening-behind---open-and---open-with.md)

package/lefthook.yml

@@ -0,0 +1,14 @@
+pre-commit:
+  jobs:
+    - name: lint
+      run: yarn lint
+
+pre-push:
+  jobs:
+    - name: ci
+      run: yarn ci
+
+commit-msg:
+  jobs:
+    - name: commitlint
+      run: yarn -s commitlint --edit {1}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meza/adr-tools",
-  "version": "1.0.12",
+  "version": "2.0.1",
   "exports": {
     ".": {
       "import": {
@@ -17,23 +17,25 @@
   "types": "dist/index.d.ts",
   "private": false,
   "scripts": {
-    "prebuild": "./scripts/inject-version.sh ./src/version.ts",
-    "prepack": "./scripts/inject-version.sh ./src/version.ts && tsc && yarn copy ",
+    "prebuild": "node ./scripts/inject-version.mjs ./src/version.ts",
+    "prepack": "node ./scripts/inject-version.mjs ./src/version.ts && tsc && yarn copy ",
     "copy": "copyfiles -u 1 ./src/templates/** ./dist",
     "build": "tsc && yarn copy",
     "start": "ts-node src/index.ts",
     "commit": "cz",
-    "ci": "npm set editor 'true' && npm-run-all --parallel lint test",
+    "commitlint": "commitlint",
+    "ci": "npm-run-all lint test",
     "ci:dev": "exit 0",
     "clean": "rimraf dist .cache/tsbuildinfo",
     "clean:all": "yarn clean && rm -rf node_modules .cache",
+    "fix:lint": "biome check --fix",
     "lint:ci": "biome ci --reporter=github",
     "lint:tsc": "tsc --noEmit",
     "lint": "npm-run-all --parallel lint:*",
-    "test": "npm-run-all --parallel test:*",
-    "test:unit": "vitest",
+    "test": "npm-run-all test:unit test:e2e",
+    "test:unit": "vitest --coverage",
     "test:e2e": "vitest --config vitest.config.e2e.ts",
-    "prepare": "is-ci || husky install",
+    "prepare": "is-ci || lefthook install",
     "report": "exit 0",
     "semantic-release": "semantic-release",
     "release": "semantic-release"
@@ -45,51 +47,47 @@
     "commander": "12.1.0",
     "core-js": "3.42.0",
     "inquirer": "9.3.7",
-    "marked": "4.3.0"
+    "marked": "4.3.0",
+    "open": "9.1.0"
   },
   "commitlint": {
     "extends": [
       "@commitlint/config-conventional"
     ]
   },
-  "husky": {
-    "hooks": {
-      "post-merge": "install-deps-postmerge",
-      "pre-push": "yarn ci",
-      "pre-commit": "yarn lint",
-      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
-    }
-  },
   "devDependencies": {
-    "@biomejs/biome": "1.9.4",
+    "@biomejs/biome": "2.3.11",
     "@commitlint/cli": "19.8.1",
     "@commitlint/config-conventional": "19.8.1",
     "@commitlint/prompt-cli": "19.8.1",
     "@faker-js/faker": "9.8.0",
     "@meza/adr-tools": "1.0.10",
+    "@meza/biome": "^1.1.3",
     "@meza/tsconfig-base": "1.1.0",
     "@ryansonshine/commitizen": "4.2.8",
     "@ryansonshine/cz-conventional-changelog": "3.3.4",
-    "@semantic-release/changelog": "6.0.3",
-    "@semantic-release/commit-analyzer": "13.0.1",
-    "@semantic-release/git": "10.0.1",
-    "@semantic-release/github": "11.0.2",
-    "@semantic-release/npm": "12.0.1",
-    "@semantic-release/release-notes-generator": "14.0.3",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.2",
+    "@semantic-release/npm": "^13.1.3",
+    "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/uuid": "10.0.0",
+    "@vitest/coverage-v8": "3.1.4",
     "@vitest/ui": "3.1.4",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
     "copyfiles": "2.4.1",
     "cross-env": "7.0.3",
-    "husky": "9.1.7",
     "install-deps-postmerge": "2.0.1",
     "is-ci": "4.1.0",
+    "lefthook": "2.0.13",
     "lint-staged": "16.0.0",
     "mock-cwd": "1.0.0",
     "npm-run-all2": "8.0.3",
     "rimraf": "6.0.1",
-    "semantic-release": "24.2.4",
+    "semantic-release": "^25.0.2",
     "ts-node": "10.9.2",
-    "tsx": "^4.19.4",
+    "tsx": "^4.21.0",
     "typescript": "5.8.3",
     "uuid": "11.1.0",
     "vitest": "3.1.4",

package/scripts/inject-version.mjs

@@ -0,0 +1,34 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+export const buildVersionSource = (version) => `export const LIB_VERSION = '${version}';\n`;
+
+export const resolveTargetPath = (argv) => {
+  const target = argv[2];
+  if (!target) {
+    throw new Error('Usage: node scripts/inject-version.mjs <output-file>');
+  }
+  return target;
+};
+
+export const writeVersionFile = (target, version) => {
+  writeFileSync(resolve(process.cwd(), target), buildVersionSource(version), 'utf8');
+};
+
+const readPackageVersion = () =>
+  JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+
+const run = () => {
+  try {
+    const target = resolveTargetPath(process.argv);
+    writeVersionFile(target, readPackageVersion());
+  } catch (error) {
+    console.error(error.message);
+    process.exit(1);
+  }
+};
+
+if (pathToFileURL(process.argv[1]).href === import.meta.url) {
+  run();
+}