@ztothez/design-engineering 2.0.0

package/dist/cli/aggregate-gates.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/aggregate-gates.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { formatAggregateReport } from "../src/aggregate/report.js";
+import { aggregateQualityGates } from "../src/aggregate/runner.js";
+function usage() {
+    return [
+        "Usage: npm run aggregate-gates -- --contract PATH --reports DIR,DIR [options]",
+        "",
+        "Options:",
+        "  --project-root PATH       Root containing contract sources, default current directory",
+        "  --output PATH             Release evidence directory",
+        "  --fail-on error|warning   Failure threshold used by every profile, default error",
+        "  --json                    Print JSON instead of Markdown",
+    ].join("\n");
+}
+function parseArguments(argumentsList) {
+    let contract = "";
+    let projectRoot = process.cwd();
+    let reportDirectories = [];
+    let outputDirectory = resolve(".ztothez-design-quality-gate", "release");
+    let failOn = "error";
+    let json = false;
+    for (let index = 0; index < argumentsList.length; index += 1) {
+        const argument = argumentsList[index];
+        const next = argumentsList[index + 1];
+        if (argument === "--contract" && next) {
+            contract = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--project-root" && next) {
+            projectRoot = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--reports" && next) {
+            reportDirectories.push(...next.split(",").filter(Boolean).map((entry) => resolve(entry)));
+            index += 1;
+        }
+        else if (argument === "--output" && next) {
+            outputDirectory = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--fail-on" && next) {
+            if (next !== "error" && next !== "warning") {
+                throw new Error("--fail-on must be error or warning");
+            }
+            failOn = next;
+            index += 1;
+        }
+        else if (argument === "--json") {
+            json = true;
+        }
+        else if (argument === "--help" || argument === "-h") {
+            process.stdout.write(`${usage()}\n`);
+            process.exit(0);
+        }
+        else {
+            throw new Error(`Unknown or incomplete argument: ${argument}`);
+        }
+    }
+    if (!contract)
+        throw new Error("--contract is required");
+    if (reportDirectories.length === 0)
+        throw new Error("--reports is required");
+    return { contract, projectRoot, reportDirectories, outputDirectory, failOn, json };
+}
+async function main() {
+    const options = parseArguments(process.argv.slice(2));
+    const report = await aggregateQualityGates({
+        contractPath: options.contract,
+        projectRoot: options.projectRoot,
+        reportDirectories: options.reportDirectories,
+        outputDirectory: options.outputDirectory,
+        failOn: options.failOn,
+    });
+    process.stdout.write(`${options.json ? JSON.stringify(report, null, 2) : formatAggregateReport(report)}\n`);
+    if (!report.complete)
+        process.exitCode = 2;
+    else if (!report.passed)
+        process.exitCode = 1;
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`Quality gate aggregation failed: ${message}\n\n${usage()}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=aggregate-gates.js.map

package/dist/cli/aggregate-gates.js.map

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

package/dist/cli/assess-maintainer-review.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/assess-maintainer-review.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { evaluateInterfaceComparison } from "../src/comparison/evaluator.js";
+import { assessSoloMaintainerTrack, formatMaintainerAssessment, } from "../src/comparison/maintainer.js";
+import { loadComparisonMethodology, loadComparisonReview, } from "../src/comparison/loader.js";
+function usage() {
+    return [
+        "Usage: npm run assess-maintainer -- --methodology PATH --review PATH [--output PATH] [--json] [--require-engineering-ready]",
+        "",
+        "Evaluates disclosed maintainer evidence for continued engineering without converting it into independent release validation.",
+    ].join("\n");
+}
+function parseArguments(argumentsList) {
+    const options = { methodology: "", review: "", json: false, requireEngineeringReady: false };
+    for (let index = 0; index < argumentsList.length; index += 1) {
+        const argument = argumentsList[index];
+        const next = argumentsList[index + 1];
+        if (argument === "--methodology" && next) {
+            options.methodology = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--review" && next) {
+            options.review = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--output" && next) {
+            options.output = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--json") {
+            options.json = true;
+        }
+        else if (argument === "--require-engineering-ready") {
+            options.requireEngineeringReady = true;
+        }
+        else {
+            throw new Error(`Unknown or incomplete argument: ${argument}`);
+        }
+    }
+    if (!options.methodology)
+        throw new Error("--methodology is required");
+    if (!options.review)
+        throw new Error("--review is required");
+    return options;
+}
+async function main() {
+    const argumentsList = process.argv.slice(2);
+    if (argumentsList.includes("--help") || argumentsList.includes("-h")) {
+        process.stdout.write(`${usage()}\n`);
+        return;
+    }
+    const options = parseArguments(argumentsList);
+    const [methodology, review] = await Promise.all([
+        loadComparisonMethodology(options.methodology),
+        loadComparisonReview(options.review),
+    ]);
+    const comparisonReport = await evaluateInterfaceComparison(methodology, review, options.methodology, options.review);
+    const assessment = assessSoloMaintainerTrack(methodology, review, comparisonReport);
+    if (options.output) {
+        await writeFile(options.output, `${JSON.stringify(assessment, null, 2)}\n`, "utf8");
+    }
+    process.stdout.write(`${options.json ? JSON.stringify(assessment, null, 2) : formatMaintainerAssessment(assessment)}\n`);
+    if (options.requireEngineeringReady && !assessment.engineeringReady)
+        process.exitCode = 1;
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`Solo-maintainer assessment failed: ${message}\n\n${usage()}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=assess-maintainer-review.js.map

package/dist/cli/assess-maintainer-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assess-maintainer-review.js","sourceRoot":"","sources":["../../cli/assess-maintainer-review.ts"],"names":[],"mappings":"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"}

package/dist/cli/audit.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/audit.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { formatAuditReport } from "../src/audit/report.js";
+import { auditRepository } from "../src/audit/scanner.js";
+function usage() {
+    return [
+        "Usage: npm run audit -- --repo PATH [--json] [--fail-on error|warning|none]",
+        "",
+        "Defaults to the current directory and exits non-zero when error findings exist.",
+    ].join("\n");
+}
+function parseArguments(argumentsList) {
+    let repository = process.cwd();
+    let json = false;
+    let failOn = "error";
+    for (let index = 0; index < argumentsList.length; index += 1) {
+        const argument = argumentsList[index];
+        if (argument === "--repo") {
+            const value = argumentsList[index + 1];
+            if (!value) {
+                throw new Error("--repo requires a directory path");
+            }
+            repository = resolve(value);
+            index += 1;
+            continue;
+        }
+        if (argument === "--json") {
+            json = true;
+            continue;
+        }
+        if (argument === "--fail-on") {
+            const value = argumentsList[index + 1];
+            if (value !== "error" && value !== "warning" && value !== "none") {
+                throw new Error("--fail-on must be error, warning, or none");
+            }
+            failOn = value;
+            index += 1;
+            continue;
+        }
+        if (argument === "--help" || argument === "-h") {
+            process.stdout.write(`${usage()}\n`);
+            process.exit(0);
+        }
+        throw new Error(`Unknown argument: ${argument}`);
+    }
+    return { repository, json, failOn };
+}
+function shouldFail(options, errors, warnings) {
+    if (options.failOn === "none") {
+        return false;
+    }
+    if (options.failOn === "warning") {
+        return errors + warnings > 0;
+    }
+    return errors > 0;
+}
+async function main() {
+    const options = parseArguments(process.argv.slice(2));
+    const report = await auditRepository(options.repository);
+    const output = options.json ? JSON.stringify(report, null, 2) : formatAuditReport(report);
+    process.stdout.write(`${output}\n`);
+    if (shouldFail(options, report.summary.errors, report.summary.warnings)) {
+        process.exitCode = 1;
+    }
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`Repository audit failed: ${message}\n\n${usage()}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=audit.js.map

package/dist/cli/audit.js.map

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

package/dist/cli/compile-comparison-review.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/compile-comparison-review.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+import { createHash } from "node:crypto";
+import { readFile, readdir, writeFile } from "node:fs/promises";
+import { dirname, extname, isAbsolute, relative, resolve, sep } from "node:path";
+import { parse, stringify } from "yaml";
+import { z } from "zod";
+import { evaluateInterfaceComparison } from "../src/comparison/evaluator.js";
+import { loadComparisonMethodology, loadComparisonReview, } from "../src/comparison/loader.js";
+import { comparisonReviewSchema, comparisonReviewSessionSchema, } from "../src/comparison/schema.js";
+const sessionEnvelopeSchema = z
+    .object({
+    version: z.literal("1.0"),
+    status: z.literal("complete"),
+    session: comparisonReviewSessionSchema,
+})
+    .strict();
+function usage() {
+    return [
+        "Usage: npm run compile-comparison -- --methodology PATH --base-review PATH --sessions DIRECTORY --output PATH [--report PATH] [--require-release-ready]",
+        "",
+        "Compiles reviewer-supplied complete session files into a comparison review, hashes each source file, and evaluates the configured human and benchmark thresholds.",
+        "Draft templates are rejected. The command never creates or upgrades human evidence.",
+    ].join("\n");
+}
+function parseArguments(argumentsList) {
+    const values = { requireReleaseReady: false };
+    for (let index = 0; index < argumentsList.length; index += 1) {
+        const argument = argumentsList[index];
+        if (!argument)
+            continue;
+        if (["--methodology", "--base-review", "--sessions", "--output", "--report"].includes(argument)) {
+            const value = argumentsList[index + 1];
+            if (!value)
+                throw new Error(`${argument} requires a value`);
+            const key = argument.slice(2).replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+            values[key] = resolve(value);
+            index += 1;
+        }
+        else if (argument === "--require-release-ready") {
+            values.requireReleaseReady = true;
+        }
+        else {
+            throw new Error(`Unknown or incomplete argument: ${argument}`);
+        }
+    }
+    if (!values.methodology || !values.baseReview || !values.sessions || !values.output) {
+        throw new Error("--methodology, --base-review, --sessions, and --output are required");
+    }
+    return {
+        methodology: values.methodology,
+        baseReview: values.baseReview,
+        sessions: values.sessions,
+        output: values.output,
+        report: values.report ?? `${values.output}.report.json`,
+        requireReleaseReady: values.requireReleaseReady ?? false,
+    };
+}
+function contained(base, candidate) {
+    const relation = relative(base, candidate);
+    return relation === "" || (!relation.startsWith(`..${sep}`) && relation !== ".." && !isAbsolute(relation));
+}
+function portable(path) {
+    return path.split(sep).join("/");
+}
+async function sha256(path) {
+    return createHash("sha256").update(await readFile(path)).digest("hex");
+}
+async function main() {
+    const options = parseArguments(process.argv.slice(2));
+    const reviewRoot = dirname(options.baseReview);
+    if (!contained(reviewRoot, options.sessions)) {
+        throw new Error("Session directory must remain inside the base review evidence directory");
+    }
+    if (!contained(reviewRoot, options.output) || !contained(reviewRoot, options.report)) {
+        throw new Error("Compiled review and report must remain inside the base review evidence directory");
+    }
+    const [methodology, baseReview, entries] = await Promise.all([
+        loadComparisonMethodology(options.methodology),
+        loadComparisonReview(options.baseReview),
+        readdir(options.sessions, { withFileTypes: true }),
+    ]);
+    const sessionFiles = entries
+        .filter((entry) => entry.isFile() && /^\.ya?ml$/i.test(extname(entry.name)))
+        .map((entry) => resolve(options.sessions, entry.name))
+        .sort();
+    if (sessionFiles.length === 0) {
+        throw new Error("No completed YAML session files were found");
+    }
+    const envelopes = await Promise.all(sessionFiles.map(async (path) => ({
+        path,
+        envelope: sessionEnvelopeSchema.parse(parse(await readFile(path, "utf8"))),
+    })));
+    for (const { envelope } of envelopes) {
+        if (envelope.session.level === "ai-assisted-expert") {
+            throw new Error(`Completed session ${envelope.session.id} must be human-expert or representative-user evidence`);
+        }
+    }
+    const sessionIds = envelopes.map(({ envelope }) => envelope.session.id);
+    if (new Set(sessionIds).size !== sessionIds.length) {
+        throw new Error("Completed session IDs must be unique");
+    }
+    const review = comparisonReviewSchema.parse({
+        ...baseReview,
+        id: `${baseReview.id.replace(/-base$/, "")}-compiled`,
+        preparedAt: new Date(Math.max(...envelopes.map(({ envelope }) => Date.parse(envelope.session.recordedAt)))).toISOString(),
+        preparedBy: { type: "mixed", name: "ZtotheZ Design Engineering and attributed reviewers" },
+        sessions: [
+            ...baseReview.sessions.filter((session) => session.origin === "agent-generated"),
+            ...envelopes.map(({ envelope }) => envelope.session),
+        ],
+        artifacts: [
+            ...baseReview.artifacts.filter((artifact) => artifact.stage !== "human-review"),
+            ...await Promise.all(envelopes.map(async ({ path, envelope }) => ({
+                id: `${envelope.session.id}-evidence`,
+                candidate: "comparison",
+                stage: "human-review",
+                kind: envelope.session.level === "representative-user" ? "user-session" : "human-review",
+                path: portable(relative(reviewRoot, path)),
+                producer: "human",
+                retained: true,
+                scope: `${envelope.session.level} session supplied by the attributed contributor`,
+                recordedAt: envelope.session.recordedAt,
+                sourceRevision: "reviewer-supplied",
+                sha256: await sha256(path),
+            }))),
+        ],
+        stages: baseReview.stages.map((stage) => stage.id === "human-review" && stage.candidate === "comparison"
+            ? { ...stage, status: "not-run", evidenceRefs: [] }
+            : stage),
+        claims: baseReview.claims,
+    });
+    const provisional = await evaluateInterfaceComparison(methodology, review, options.methodology, options.output);
+    if (provisional.humanReview.requirementsMet) {
+        const humanEvidenceRefs = review.artifacts
+            .filter((artifact) => artifact.stage === "human-review")
+            .map((artifact) => artifact.id);
+        review.stages = review.stages.map((stage) => stage.id === "human-review" && stage.candidate === "comparison"
+            ? { ...stage, status: "pass", evidenceRefs: humanEvidenceRefs }
+            : stage);
+    }
+    const report = await evaluateInterfaceComparison(methodology, review, options.methodology, options.output);
+    await writeFile(options.output, stringify(review, { lineWidth: 120 }), "utf8");
+    await writeFile(options.report, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    if (!report.passed || (options.requireReleaseReady && !report.releaseReady)) {
+        process.exitCode = 1;
+    }
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`Comparison review compilation failed: ${message}\n\n${usage()}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=compile-comparison-review.js.map

package/dist/cli/compile-comparison-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-comparison-review.js","sourceRoot":"","sources":["../../cli/compile-comparison-review.ts"],"names":[],"mappings":"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"}

package/dist/cli/compile-plan.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function runCompilePlanCli(argumentsList: string[]): Promise<number>;

package/dist/cli/compile-plan.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { compileDesignPlan } from "../src/design-plan/compiler.js";
+import { formatDesignPlan } from "../src/design-plan/report.js";
+import { loadProductDesignBrief } from "../src/product-brief/loader.js";
+function usage() {
+    return [
+        "Usage: zz-design compile-plan --brief PATH [--project-root PATH] [--json]",
+        "",
+        "Compiles a generation-ready product design brief into a deterministic, traceable design plan.",
+        "Planned contracts and unconfirmed target routes remain provisional instead of becoming invented implementation certainty.",
+    ].join("\n");
+}
+function parseArguments(argumentsList) {
+    let brief = "";
+    let projectRoot = process.cwd();
+    let json = false;
+    for (let index = 0; index < argumentsList.length; index += 1) {
+        const argument = argumentsList[index];
+        const next = argumentsList[index + 1];
+        if (argument === "--brief" && next) {
+            brief = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--project-root" && next) {
+            projectRoot = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--json") {
+            json = true;
+        }
+        else {
+            throw new Error(`Unknown or incomplete argument: ${argument}`);
+        }
+    }
+    if (!brief)
+        throw new Error("--brief is required");
+    return { brief, projectRoot, json };
+}
+export async function runCompilePlanCli(argumentsList) {
+    if (argumentsList.includes("--help") || argumentsList.includes("-h")) {
+        process.stdout.write(`${usage()}\n`);
+        return 0;
+    }
+    const options = parseArguments(argumentsList);
+    const brief = await loadProductDesignBrief(options.brief);
+    const plan = await compileDesignPlan(brief, {
+        briefSourcePath: options.brief,
+        projectRoot: options.projectRoot,
+    });
+    process.stdout.write(`${options.json ? JSON.stringify(plan, null, 2) : formatDesignPlan(plan)}\n`);
+    return plan.status === "blocked" ? 1 : 0;
+}
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+    runCompilePlanCli(process.argv.slice(2))
+        .then((exitCode) => {
+        process.exitCode = exitCode;
+    })
+        .catch((error) => {
+        const message = error instanceof Error ? error.stack ?? error.message : String(error);
+        process.stderr.write(`Design plan compilation failed: ${message}\n\n${usage()}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=compile-plan.js.map

package/dist/cli/compile-plan.js.map

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

package/dist/cli/evaluate-corpus.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/evaluate-corpus.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { evaluateCorpusBenchmark } from "../src/corpus/evaluator.js";
+import { formatCorpusReport } from "../src/corpus/report.js";
+function usage() {
+    return [
+        "Usage: npm run evaluate-corpus -- [--manifest PATH] [--project-root PATH] [--output DIR] [--json]",
+        "",
+        "Evaluates versioned positive and negative cases for retrieval relevance, abstention, architecture, task completeness, and anti-slop rejection.",
+    ].join("\n");
+}
+function parseArguments(args) {
+    let manifest = "knowledge-base/benchmarks/corpus/corpus.yaml";
+    let projectRoot = process.cwd();
+    let json = false;
+    let output;
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        const next = args[index + 1];
+        if (argument === "--manifest" && next) {
+            manifest = next;
+            index += 1;
+        }
+        else if (argument === "--project-root" && next) {
+            projectRoot = next;
+            index += 1;
+        }
+        else if (argument === "--json") {
+            json = true;
+        }
+        else if (argument === "--output" && next) {
+            output = resolve(next);
+            index += 1;
+        }
+        else {
+            throw new Error(`Unknown or incomplete argument: ${argument}`);
+        }
+    }
+    return { manifest: resolve(manifest), projectRoot: resolve(projectRoot), json, ...(output ? { output } : {}) };
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(`${usage()}\n`);
+        return;
+    }
+    const options = parseArguments(args);
+    const report = await evaluateCorpusBenchmark(options.manifest, options.projectRoot);
+    const markdown = formatCorpusReport(report);
+    if (options.output) {
+        await mkdir(options.output, { recursive: true });
+        await writeFile(join(options.output, "corpus-report.json"), `${JSON.stringify(report, null, 2)}\n`, "utf8");
+        await writeFile(join(options.output, "corpus-report.md"), `${markdown}\n`, "utf8");
+    }
+    process.stdout.write(`${options.json ? JSON.stringify(report, null, 2) : markdown}\n`);
+    if (!report.passed)
+        process.exitCode = 1;
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`Corpus evaluation failed: ${message}\n\n${usage()}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=evaluate-corpus.js.map

package/dist/cli/evaluate-corpus.js.map

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

package/dist/cli/generate-react.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function runGenerateReactCli(argumentsList: string[]): Promise<number>;