@deftai/directive 0.61.2 → 0.63.0

package/dist/release-e2e-parity.js

@@ -1,114 +0,0 @@
-#!/usr/bin/env node
-/**
- * Golden-output parity harness (#1729): runs BOTH the Python oracle
- * (`scripts/release_e2e.py`) and the ported TS release:e2e CLI with
- * identical argv, then diffs exit codes and normalised stderr/stdout.
- */
-import { spawnSync } from "node:child_process";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-export const PARITY_SCENARIOS = [
-    { name: "help", argv: ["--help"], compareStdout: true },
-    { name: "dry-run", argv: ["--dry-run"] },
-    { name: "dry-run-keep-repo", argv: ["--dry-run", "--keep-repo"] },
-    {
-        name: "dry-run-project-root",
-        argv: ["--dry-run", "--owner", "deftai", "--project-root", "/tmp/deft-e2e-parity-root"],
-    },
-];
-/** Normalise volatile repo slugs and ISO dates in stderr while preserving semantics. */
-export function normaliseStderr(text) {
-    return text
-        .replace(/deftai-release-test-\d{14}-[0-9a-f]{6}/g, "deftai-release-test-YYYYMMDDHHMMSS-uuid6")
-        .replace(/\d{4}-\d{2}-\d{2}/g, "YYYY-MM-DD");
-}
-function runCapture(cmd, args, cwd) {
-    const result = spawnSync(cmd, args, {
-        cwd,
-        encoding: "utf8",
-        env: {
-            ...process.env,
-            DEFT_CACHE_DISABLE: "1",
-            PYTHONUTF8: "1",
-        },
-        stdio: ["ignore", "pipe", "pipe"],
-    });
-    return {
-        exitCode: result.status ?? 2,
-        stdout: typeof result.stdout === "string" ? result.stdout : "",
-        stderr: typeof result.stderr === "string" ? result.stderr : "",
-    };
-}
-function resolveDeftRoot() {
-    if (process.env.DEFT_ROOT !== undefined && process.env.DEFT_ROOT.length > 0) {
-        return resolve(process.env.DEFT_ROOT);
-    }
-    return resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
-}
-function runScenario(deftRoot, scenario) {
-    const argv = [...scenario.argv];
-    const py = runCapture("uv", ["run", "python", join(deftRoot, "scripts", "release_e2e.py"), ...argv], deftRoot);
-    const ts = runCapture("node", [join(deftRoot, "packages", "cli", "dist", "release-e2e.js"), ...argv], deftRoot);
-    const stream = scenario.compareStdout ? "stdout" : "stderr";
-    let pythonOutput = stream === "stdout" ? py.stdout : py.stderr;
-    let tsOutput = stream === "stdout" ? ts.stdout : ts.stderr;
-    if (stream === "stderr") {
-        pythonOutput = normaliseStderr(pythonOutput);
-        tsOutput = normaliseStderr(tsOutput);
-    }
-    return {
-        name: scenario.name,
-        exitMismatch: py.exitCode !== ts.exitCode,
-        outputMismatch: pythonOutput !== tsOutput,
-        pythonExit: py.exitCode,
-        tsExit: ts.exitCode,
-        pythonOutput,
-        tsOutput,
-        stream,
-    };
-}
-export function runParity() {
-    const deftRoot = resolveDeftRoot();
-    const diffs = PARITY_SCENARIOS.map((scenario) => runScenario(deftRoot, scenario));
-    const ok = diffs.every((d) => !d.exitMismatch && !d.outputMismatch);
-    return { ok, diffs };
-}
-export function renderReport(result) {
-    if (result.ok) {
-        return `release-e2e parity: CLEAN -- Python and TS agree on ${result.diffs.length} scenario(s).`;
-    }
-    const lines = ["release-e2e parity: DIVERGENCE"];
-    for (const d of result.diffs) {
-        if (d.exitMismatch || d.outputMismatch) {
-            lines.push(`  scenario: ${d.name}`);
-            if (d.exitMismatch) {
-                lines.push(`    exit mismatch: python=${d.pythonExit} ts=${d.tsExit}`);
-            }
-            if (d.outputMismatch) {
-                lines.push(`    stream: ${d.stream}`);
-                lines.push(`    python (${d.pythonOutput.length} bytes):`);
-                lines.push(d.pythonOutput);
-                lines.push(`    ts (${d.tsOutput.length} bytes):`);
-                lines.push(d.tsOutput);
-            }
-        }
-    }
-    return lines.join("\n");
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    try {
-        const result = runParity();
-        if (result.ok) {
-            process.stdout.write(`${renderReport(result)}\n`);
-            process.exit(0);
-        }
-        process.stderr.write(`${renderReport(result)}\n`);
-        process.exit(1);
-    }
-    catch (err) {
-        const msg = String(err).replace(/\r?\n/g, " ");
-        process.stderr.write(`release-e2e parity: harness error -- ${msg}\n`);
-        process.exit(2);
-    }
-}
-//# sourceMappingURL=release-e2e-parity.js.map

package/dist/release-parity.d.ts

@@ -1,40 +0,0 @@
-#!/usr/bin/env node
-export declare const SAMPLE_CHANGELOG = " Changelog\n\nAll notable changes to the project.\n\n## [Unreleased]\n\n### Added\n- New release automation (#74)\n\n### Changed\n- Refactored module X\n\n### Fixed\n- Bug Y\n\n## [0.20.2] - 2026-04-24\n\n### Added\n- Prior change\n\n## [0.20.0] - 2026-04-23\n\n### Added\n- Older change\n\n[Unreleased]: https://github.com/deftai/directive/compare/v0.20.2...HEAD\n[0.20.2]: https://github.com/deftai/directive/compare/v0.20.0...v0.20.2\n[0.20.0]: https://github.com/deftai/directive/compare/v0.19.0...v0.20.0\n";
-export interface ScenarioResult {
-    readonly name: string;
-    readonly exitCode: number;
-    readonly stdout: string;
-    readonly stderr: string;
-}
-export interface ParityScenario {
-    readonly name: string;
-    readonly argv: readonly string[];
-    readonly setup?: (root: string) => void;
-    readonly compareStdout?: boolean;
-}
-export interface ParityResult {
-    readonly ok: boolean;
-    readonly scenarios: Array<{
-        readonly name: string;
-        readonly exitMismatch: boolean;
-        readonly pythonExit: number;
-        readonly tsExit: number;
-        readonly outputMismatch: boolean;
-        readonly pythonOutput: string;
-        readonly tsOutput: string;
-        readonly stream: "stdout" | "stderr";
-    }>;
-}
-export declare const PARITY_SCENARIOS: readonly ParityScenario[];
-/** Normalise volatile ISO dates in stderr while preserving semantics. */
-export declare function normaliseStderr(text: string): string;
-export declare function pickOutput(result: ScenarioResult, stream: "stdout" | "stderr"): string;
-export declare function diffParity(python: ScenarioResult, ts: ScenarioResult, stream: "stdout" | "stderr"): {
-    exitMismatch: boolean;
-    outputMismatch: boolean;
-    pythonOutput: string;
-    tsOutput: string;
-};
-export declare function runParity(): ParityResult;
-export declare function renderReport(result: ParityResult): string;
-//# sourceMappingURL=release-parity.d.ts.map

package/dist/release-parity.js

@@ -1,226 +0,0 @@
-#!/usr/bin/env node
-/**
- * Golden-output parity harness (#1729): runs BOTH the Python oracle
- * (`scripts/release.py`) and the ported TS release CLI with identical argv,
- * then diffs exit codes and normalised stderr/stdout. Exit 0 only on
- * byte-identical results (volatile ISO dates normalised in stderr).
- *
- * Exit codes: 0 parity / 1 divergence / 2 harness setup error.
- */
-import { execFileSync, spawnSync } from "node:child_process";
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-export const SAMPLE_CHANGELOG = ` Changelog
-
-All notable changes to the project.
-
-## [Unreleased]
-
-### Added
-- New release automation (#74)
-
-### Changed
-- Refactored module X
-
-### Fixed
-- Bug Y
-
-## [0.20.2] - 2026-04-24
-
-### Added
-- Prior change
-
-## [0.20.0] - 2026-04-23
-
-### Added
-- Older change
-
-[Unreleased]: https://github.com/deftai/directive/compare/v0.20.2...HEAD
-[0.20.2]: https://github.com/deftai/directive/compare/v0.20.0...v0.20.2
-[0.20.0]: https://github.com/deftai/directive/compare/v0.19.0...v0.20.0
-`;
-export const PARITY_SCENARIOS = [
-    { name: "invalid-version", argv: ["not-a-version"] },
-    {
-        name: "dry-run-fixture",
-        argv: [
-            "0.21.0",
-            "--dry-run",
-            "--skip-tag",
-            "--skip-release",
-            "--repo",
-            "deftai/directive",
-            "--allow-vbrief-drift",
-            "--skip-ci",
-        ],
-        setup(root) {
-            writeFileSync(join(root, "CHANGELOG.md"), SAMPLE_CHANGELOG, "utf8");
-            execFileSync("git", ["init", "-q", "-b", "master", root]);
-            execFileSync("git", ["config", "user.email", "parity@test.local"], { cwd: root });
-            execFileSync("git", ["config", "user.name", "deft-parity"], { cwd: root });
-            execFileSync("git", ["add", "CHANGELOG.md"], { cwd: root });
-            execFileSync("git", ["commit", "-q", "-m", "init"], {
-                cwd: root,
-                env: {
-                    ...process.env,
-                    GIT_AUTHOR_NAME: "deft-parity",
-                    GIT_AUTHOR_EMAIL: "parity@test.local",
-                    GIT_COMMITTER_NAME: "deft-parity",
-                    GIT_COMMITTER_EMAIL: "parity@test.local",
-                },
-            });
-        },
-    },
-    { name: "help", argv: ["--help"], compareStdout: true },
-];
-function runCapture(cmd, args, cwd, env = {}) {
-    const merged = {
-        ...process.env,
-        ...env,
-        DEFT_CACHE_DISABLE: "1",
-        PYTHONUTF8: "1",
-    };
-    for (const key of Object.keys(merged)) {
-        if (merged[key] === undefined)
-            delete merged[key];
-    }
-    try {
-        const result = spawnSync(cmd, args, {
-            cwd,
-            encoding: "utf8",
-            env: merged,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        return {
-            status: result.status ?? 2,
-            stdout: typeof result.stdout === "string" ? result.stdout : "",
-            stderr: typeof result.stderr === "string" ? result.stderr : "",
-        };
-    }
-    catch (err) {
-        const e = err;
-        return {
-            status: typeof e.status === "number" ? e.status : 2,
-            stdout: typeof e.stdout === "string" ? e.stdout : "",
-            stderr: typeof e.stderr === "string" ? e.stderr : "",
-        };
-    }
-}
-function resolveDeftRoot() {
-    if (process.env.DEFT_ROOT !== undefined && process.env.DEFT_ROOT.length > 0) {
-        return resolve(process.env.DEFT_ROOT);
-    }
-    return resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
-}
-/** Normalise volatile ISO dates in stderr while preserving semantics. */
-export function normaliseStderr(text) {
-    return text
-        .replace(/\d{4}-\d{2}-\d{2}/g, "YYYY-MM-DD")
-        .replace(/(?:\/private)?\/var\/folders\/[^\s)]+\/deft-release-parity-[^\s)]+/g, "<TMP>")
-        .replace(/\/tmp\/deft-release-parity-[^\s)]+/g, "<TMP>");
-}
-export function pickOutput(result, stream) {
-    return stream === "stdout" ? result.stdout : result.stderr;
-}
-function runScenario(deftRoot, scenario) {
-    let cwd = deftRoot;
-    let tempRoot;
-    let projectRoot;
-    const argv = [...scenario.argv];
-    if (scenario.setup) {
-        tempRoot = mkdtempSync(join(tmpdir(), "deft-release-parity-"));
-        projectRoot = tempRoot;
-        scenario.setup(tempRoot);
-        const idx = argv.indexOf("--project-root");
-        if (idx === -1) {
-            argv.push("--project-root", tempRoot);
-        }
-        cwd = deftRoot;
-    }
-    try {
-        const pyArgs = ["run", "python", join(deftRoot, "scripts", "release.py"), ...argv];
-        const tsArgs = [join(deftRoot, "packages", "cli", "dist", "release.js"), ...argv];
-        const py = runCapture("uv", pyArgs, cwd);
-        const ts = runCapture("node", tsArgs, cwd);
-        return {
-            python: { name: scenario.name, exitCode: py.status, stdout: py.stdout, stderr: py.stderr },
-            ts: { name: scenario.name, exitCode: ts.status, stdout: ts.stdout, stderr: ts.stderr },
-            projectRoot,
-        };
-    }
-    finally {
-        if (tempRoot) {
-            rmSync(tempRoot, { recursive: true, force: true });
-        }
-    }
-}
-export function diffParity(python, ts, stream) {
-    let pythonOutput = pickOutput(python, stream);
-    let tsOutput = pickOutput(ts, stream);
-    if (stream === "stderr") {
-        pythonOutput = normaliseStderr(pythonOutput);
-        tsOutput = normaliseStderr(tsOutput);
-    }
-    return {
-        exitMismatch: python.exitCode !== ts.exitCode,
-        outputMismatch: pythonOutput !== tsOutput,
-        pythonOutput,
-        tsOutput,
-    };
-}
-export function runParity() {
-    const deftRoot = resolveDeftRoot();
-    const scenarios = [];
-    for (const scenario of PARITY_SCENARIOS) {
-        const ran = runScenario(deftRoot, scenario);
-        const stream = scenario.compareStdout ? "stdout" : "stderr";
-        scenarios.push({
-            name: scenario.name,
-            pythonExit: ran.python.exitCode,
-            tsExit: ran.ts.exitCode,
-            stream,
-            ...diffParity(ran.python, ran.ts, stream),
-        });
-    }
-    const ok = scenarios.every((s) => !s.exitMismatch && !s.outputMismatch);
-    return { ok, scenarios };
-}
-export function renderReport(result) {
-    if (result.ok) {
-        return `release parity: CLEAN -- Python and TS agree on ${result.scenarios.length} scenario(s).`;
-    }
-    const lines = ["release parity: DIVERGENCE"];
-    for (const s of result.scenarios) {
-        if (s.exitMismatch || s.outputMismatch) {
-            lines.push(`  scenario: ${s.name}`);
-            if (s.exitMismatch) {
-                lines.push(`    exit mismatch: python=${s.pythonExit} ts=${s.tsExit}`);
-            }
-            if (s.outputMismatch) {
-                lines.push(`    stream: ${s.stream}`);
-                lines.push(`    python (${s.pythonOutput.length} bytes)`);
-                lines.push(`    ts (${s.tsOutput.length} bytes)`);
-            }
-        }
-    }
-    return lines.join("\n");
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    try {
-        const result = runParity();
-        if (result.ok) {
-            process.stdout.write(`${renderReport(result)}\n`);
-            process.exit(0);
-        }
-        process.stderr.write(`${renderReport(result)}\n`);
-        process.exit(1);
-    }
-    catch (err) {
-        const msg = String(err).replace(/\r?\n/g, " ");
-        process.stderr.write(`release parity: harness error -- ${msg}\n`);
-        process.exit(2);
-    }
-}
-//# sourceMappingURL=release-parity.js.map

package/dist/release-publish-parity.d.ts

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-export interface ScenarioResult {
-    readonly name: string;
-    readonly exitCode: number;
-    readonly stdout: string;
-    readonly stderr: string;
-}
-export interface ParityScenario {
-    readonly name: string;
-    readonly argv: readonly string[];
-    readonly compareStdout?: boolean;
-}
-export interface ParityResult {
-    readonly ok: boolean;
-    readonly scenarios: Array<{
-        readonly name: string;
-        readonly exitMismatch: boolean;
-        readonly pythonExit: number;
-        readonly tsExit: number;
-        readonly outputMismatch: boolean;
-        readonly pythonOutput: string;
-        readonly tsOutput: string;
-        readonly stream: "stdout" | "stderr";
-    }>;
-}
-export declare const PARITY_SCENARIOS: readonly ParityScenario[];
-export declare function pickOutput(result: ScenarioResult, stream: "stdout" | "stderr"): string;
-export declare function diffParity(python: ScenarioResult, ts: ScenarioResult, stream: "stdout" | "stderr"): {
-    exitMismatch: boolean;
-    outputMismatch: boolean;
-    pythonOutput: string;
-    tsOutput: string;
-};
-export declare function runParity(): ParityResult;
-export declare function renderReport(result: ParityResult): string;
-//# sourceMappingURL=release-publish-parity.d.ts.map

package/dist/release-publish-parity.js

@@ -1,138 +0,0 @@
-#!/usr/bin/env node
-/**
- * Golden-output parity harness (#1729): runs BOTH the Python oracle
- * (`scripts/release_publish.py`) and the ported TS release:publish CLI
- * with identical argv, then diffs exit codes and normalised stderr/stdout.
- * Exit 0 only on byte-identical results (cache off).
- *
- * Exit codes: 0 parity / 1 divergence / 2 harness setup error.
- */
-import { spawnSync } from "node:child_process";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-export const PARITY_SCENARIOS = [
-    { name: "invalid-version", argv: ["not-a-version"] },
-    { name: "missing-version", argv: [] },
-    {
-        name: "dry-run",
-        argv: ["0.21.0", "--dry-run", "--repo", "deftai/directive"],
-    },
-    { name: "help", argv: ["--help"], compareStdout: true },
-];
-function runCapture(cmd, args, cwd, env = {}) {
-    const merged = {
-        ...process.env,
-        ...env,
-        DEFT_CACHE_DISABLE: "1",
-        PYTHONUTF8: "1",
-    };
-    for (const key of Object.keys(merged)) {
-        if (merged[key] === undefined)
-            delete merged[key];
-    }
-    try {
-        const result = spawnSync(cmd, args, {
-            cwd,
-            encoding: "utf8",
-            env: merged,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        return {
-            status: result.status ?? 2,
-            stdout: typeof result.stdout === "string" ? result.stdout : "",
-            stderr: typeof result.stderr === "string" ? result.stderr : "",
-        };
-    }
-    catch (err) {
-        const e = err;
-        return {
-            status: typeof e.status === "number" ? e.status : 2,
-            stdout: typeof e.stdout === "string" ? e.stdout : "",
-            stderr: typeof e.stderr === "string" ? e.stderr : "",
-        };
-    }
-}
-function resolveDeftRoot() {
-    if (process.env.DEFT_ROOT !== undefined && process.env.DEFT_ROOT.length > 0) {
-        return resolve(process.env.DEFT_ROOT);
-    }
-    return resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
-}
-export function pickOutput(result, stream) {
-    return stream === "stdout" ? result.stdout : result.stderr;
-}
-function runScenario(deftRoot, scenario) {
-    const argv = [...scenario.argv];
-    const pyArgs = ["run", "python", join(deftRoot, "scripts", "release_publish.py"), ...argv];
-    const tsArgs = [join(deftRoot, "packages", "cli", "dist", "release-publish.js"), ...argv];
-    const py = runCapture("uv", pyArgs, deftRoot);
-    const ts = runCapture("node", tsArgs, deftRoot);
-    return {
-        python: { name: scenario.name, exitCode: py.status, stdout: py.stdout, stderr: py.stderr },
-        ts: { name: scenario.name, exitCode: ts.status, stdout: ts.stdout, stderr: ts.stderr },
-    };
-}
-export function diffParity(python, ts, stream) {
-    const pythonOutput = pickOutput(python, stream);
-    const tsOutput = pickOutput(ts, stream);
-    return {
-        exitMismatch: python.exitCode !== ts.exitCode,
-        outputMismatch: pythonOutput !== tsOutput,
-        pythonOutput,
-        tsOutput,
-    };
-}
-export function runParity() {
-    const deftRoot = resolveDeftRoot();
-    const scenarios = [];
-    for (const scenario of PARITY_SCENARIOS) {
-        const ran = runScenario(deftRoot, scenario);
-        const stream = scenario.compareStdout ? "stdout" : "stderr";
-        scenarios.push({
-            name: scenario.name,
-            pythonExit: ran.python.exitCode,
-            tsExit: ran.ts.exitCode,
-            stream,
-            ...diffParity(ran.python, ran.ts, stream),
-        });
-    }
-    const ok = scenarios.every((s) => !s.exitMismatch && !s.outputMismatch);
-    return { ok, scenarios };
-}
-export function renderReport(result) {
-    if (result.ok) {
-        return `release-publish parity: CLEAN -- Python and TS agree on ${result.scenarios.length} scenario(s).`;
-    }
-    const lines = ["release-publish parity: DIVERGENCE"];
-    for (const s of result.scenarios) {
-        if (s.exitMismatch || s.outputMismatch) {
-            lines.push(`  scenario: ${s.name}`);
-            if (s.exitMismatch) {
-                lines.push(`    exit mismatch: python=${s.pythonExit} ts=${s.tsExit}`);
-            }
-            if (s.outputMismatch) {
-                lines.push(`    stream: ${s.stream}`);
-                lines.push(`    python (${s.pythonOutput.length} bytes)`);
-                lines.push(`    ts (${s.tsOutput.length} bytes)`);
-            }
-        }
-    }
-    return lines.join("\n");
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    try {
-        const result = runParity();
-        if (result.ok) {
-            process.stdout.write(`${renderReport(result)}\n`);
-            process.exit(0);
-        }
-        process.stderr.write(`${renderReport(result)}\n`);
-        process.exit(1);
-    }
-    catch (err) {
-        const msg = String(err).replace(/\r?\n/g, " ");
-        process.stderr.write(`release-publish parity: harness error -- ${msg}\n`);
-        process.exit(2);
-    }
-}
-//# sourceMappingURL=release-publish-parity.js.map

package/dist/release-rollback-parity.d.ts

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-export interface ScenarioResult {
-    readonly name: string;
-    readonly exitCode: number;
-    readonly stdout: string;
-    readonly stderr: string;
-}
-export interface ParityScenario {
-    readonly name: string;
-    readonly argv: readonly string[];
-    readonly compareStdout?: boolean;
-}
-export interface ParityResult {
-    readonly ok: boolean;
-    readonly scenarios: Array<{
-        readonly name: string;
-        readonly exitMismatch: boolean;
-        readonly pythonExit: number;
-        readonly tsExit: number;
-        readonly outputMismatch: boolean;
-        readonly pythonOutput: string;
-        readonly tsOutput: string;
-        readonly stream: "stdout" | "stderr";
-    }>;
-}
-export declare const PARITY_SCENARIOS: readonly ParityScenario[];
-export declare function normaliseStderr(text: string): string;
-export declare function pickOutput(result: ScenarioResult, stream: "stdout" | "stderr"): string;
-export declare function diffParity(python: ScenarioResult, ts: ScenarioResult, stream: "stdout" | "stderr"): {
-    exitMismatch: boolean;
-    outputMismatch: boolean;
-    pythonOutput: string;
-    tsOutput: string;
-};
-export declare function runParity(): ParityResult;
-export declare function renderReport(result: ParityResult): string;
-//# sourceMappingURL=release-rollback-parity.d.ts.map