@ztothez/design-engineering 2.0.0

package/dist/cli/generate-react.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadDesignPlan } from "../src/generation/loader.js";
+import { generateReactTypescriptFixture } from "../src/generation/react-typescript.js";
+import { formatGenerationReport } from "../src/generation/report.js";
+function usage() {
+    return [
+        "Usage: zz-design generate-react --plan PATH --generation-root PATH --output PATH --portfolio-registry PATH [--json]",
+        "",
+        "Creates one new independent React and TypeScript fixture from an implementation-ready design plan.",
+        "The output must not exist, must remain inside the explicit generation root, and must not overlap any portfolio root.",
+    ].join("\n");
+}
+function parseArguments(argumentsList) {
+    let plan = "";
+    let generationRoot = "";
+    let output = "";
+    let portfolioRegistry = "";
+    let json = false;
+    for (let index = 0; index < argumentsList.length; index += 1) {
+        const argument = argumentsList[index];
+        const next = argumentsList[index + 1];
+        if (argument === "--plan" && next) {
+            plan = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--generation-root" && next) {
+            generationRoot = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--output" && next) {
+            output = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--portfolio-registry" && next) {
+            portfolioRegistry = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--json") {
+            json = true;
+        }
+        else {
+            throw new Error(`Unknown or incomplete argument: ${argument}`);
+        }
+    }
+    if (!plan)
+        throw new Error("--plan is required");
+    if (!generationRoot)
+        throw new Error("--generation-root is required");
+    if (!output)
+        throw new Error("--output is required");
+    if (!portfolioRegistry)
+        throw new Error("--portfolio-registry is required");
+    return { plan, generationRoot, output, portfolioRegistry, json };
+}
+export async function runGenerateReactCli(argumentsList) {
+    if (argumentsList.includes("--help") || argumentsList.includes("-h")) {
+        process.stdout.write(`${usage()}\n`);
+        return 0;
+    }
+    const options = parseArguments(argumentsList);
+    const plan = await loadDesignPlan(options.plan);
+    const report = await generateReactTypescriptFixture(plan, {
+        generationRoot: options.generationRoot,
+        outputDirectory: options.output,
+        portfolioRegistryPath: options.portfolioRegistry,
+    });
+    process.stdout.write(`${options.json ? JSON.stringify(report, null, 2) : formatGenerationReport(report)}\n`);
+    return 0;
+}
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+    runGenerateReactCli(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(`React fixture generation failed: ${message}\n\n${usage()}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=generate-react.js.map

package/dist/cli/generate-react.js.map

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

package/dist/cli/index.d.ts

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

package/dist/cli/index.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import { basename } from "node:path";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CLI_COMMANDS, PRODUCT_ID, VERSION, formatCliHelp } from "../src/product.js";
+function writeHelp() {
+    const command = basename(process.argv[1] ?? CLI_COMMANDS[0]);
+    process.stdout.write(formatCliHelp(command));
+}
+async function main() {
+    const argumentsList = process.argv.slice(2);
+    if (argumentsList[0] === "portfolio") {
+        const { runPortfolioCli } = await import("./portfolio.js");
+        process.exitCode = await runPortfolioCli(argumentsList.slice(1), basename(process.argv[1] ?? CLI_COMMANDS[0]));
+        return;
+    }
+    if (argumentsList[0] === "validate-brief") {
+        const { runValidateBriefCli } = await import("./validate-brief.js");
+        process.exitCode = await runValidateBriefCli(argumentsList.slice(1));
+        return;
+    }
+    if (argumentsList[0] === "compile-plan") {
+        const { runCompilePlanCli } = await import("./compile-plan.js");
+        process.exitCode = await runCompilePlanCli(argumentsList.slice(1));
+        return;
+    }
+    if (argumentsList[0] === "generate-react") {
+        const { runGenerateReactCli } = await import("./generate-react.js");
+        process.exitCode = await runGenerateReactCli(argumentsList.slice(1));
+        return;
+    }
+    if (argumentsList[0] === "repair-react") {
+        const { runRepairReactCli } = await import("./repair-react.js");
+        process.exitCode = await runRepairReactCli(argumentsList.slice(1));
+        return;
+    }
+    if (process.argv.includes("--help") || process.argv.includes("-h")) {
+        writeHelp();
+        return;
+    }
+    if (process.argv.includes("--version") || process.argv.includes("-v")) {
+        process.stdout.write(`${VERSION}\n`);
+        return;
+    }
+    if (argumentsList.length > 0) {
+        throw new Error(`Unknown command: ${argumentsList[0]}`);
+    }
+    const { server } = await import("../src/server.js");
+    const transport = new StdioServerTransport();
+    process.stdin.resume();
+    await server.connect(transport);
+    console.error(`${PRODUCT_ID} MCP server connected over stdio`);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    console.error(`Failed to start ${PRODUCT_ID} MCP server:`, message);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/portfolio.d.ts

@@ -0,0 +1,2 @@
+export declare function portfolioUsage(command?: string): string;
+export declare function runPortfolioCli(argumentsList: string[], executable?: string): Promise<number>;

package/dist/cli/portfolio.js

@@ -0,0 +1,316 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { discoverPortfolioCandidates, inspectPortfolioRegistry, projectById, } from "../src/portfolio/registry.js";
+import { formatPortfolioInventoryReport, formatPortfolioRegistryReport, } from "../src/portfolio/report.js";
+import { formatPortfolioAdapterReport, formatPortfolioAdapterStageResult, } from "../src/portfolio/adapter-report.js";
+import { resolvePortfolioAdapter, runPortfolioAdapterStage, } from "../src/portfolio/adapters.js";
+import { benchmarkStageSchema } from "../src/portfolio/schema.js";
+import { closePortfolioSnapshot, createPortfolioSnapshot, withPortfolioSnapshot, } from "../src/portfolio/snapshot.js";
+import { portfolioRunExitCode, readPortfolioBenchmarkReport, runPortfolioBenchmark, verifyPortfolioRunSources, } from "../src/portfolio/runner.js";
+import { deleteProjectEvidence } from "../src/portfolio/vault.js";
+import { evaluateCrossProductTaxonomy } from "../src/portfolio/taxonomy.js";
+import { evaluateRuleCandidate } from "../src/portfolio/promotion.js";
+import { evaluateV3Qualification } from "../src/portfolio/qualification.js";
+import { verifyEvidenceReferences, verifyQualificationEvidenceSemantics, verifyRulePromotionEvidenceSemantics, } from "../src/portfolio/evidence.js";
+export function portfolioUsage(command = "zz-design") {
+    return [
+        "Usage:",
+        `  ${command} portfolio validate-registry [--registry PATH] [--json]`,
+        `  ${command} portfolio inventory [--registry PATH] [--json]`,
+        `  ${command} portfolio capabilities --project ID [--registry PATH] [--json]`,
+        `  ${command} portfolio run-stage --project ID --stage STAGE [--registry PATH] [--workspace PATH] [--json]`,
+        `  ${command} portfolio baseline --project ID [--run ID] [--registry PATH] [--json]`,
+        `  ${command} portfolio benchmark --cohort development|holdout [--run ID] [--registry PATH] [--json]`,
+        `  ${command} portfolio verify-unchanged --run ID [--registry PATH] [--json]`,
+        `  ${command} portfolio report --run ID [--json]`,
+        `  ${command} portfolio prune-evidence --run ID [--project ID] [--json]`,
+        `  ${command} portfolio cross-product --run ID [--annotations PATH] [--registry PATH] [--json]`,
+        `  ${command} portfolio evaluate-rule --candidate PATH --evidence PATH [--dev-run ID] [--holdout-run ID] [--registry PATH] [--json]`,
+        `  ${command} portfolio qualify-v3 --evidence PATH [--dev-run ID] [--holdout-run ID] [--registry PATH] [--json]`,
+        `  ${command} portfolio snapshot --project ID [--registry PATH] [--workspace PATH] [--keep] [--json]`,
+        "",
+        "The registry is local-only. Snapshot commands copy approved files into an isolated workspace",
+        "and verify that the original source remains unchanged.",
+    ].join("\n");
+}
+function parseArguments(argumentsList) {
+    const command = argumentsList[0];
+    if (!["validate-registry", "inventory", "capabilities", "run-stage", "snapshot", "baseline", "benchmark", "verify-unchanged", "report", "prune-evidence", "cross-product", "evaluate-rule", "qualify-v3"].includes(command ?? "")) {
+        throw new Error("Unknown portfolio command.");
+    }
+    const parsedCommand = command;
+    let registry = resolve(".ztothez-design-local", "portfolio-registry.yaml");
+    let workspace = resolve(".ztothez-design-benchmarks", "workspaces");
+    let runRoot = resolve(".ztothez-design-benchmarks", "runs");
+    let project;
+    let stage;
+    let cohort;
+    let runId;
+    let candidatePath;
+    let evidencePath;
+    let devRunId;
+    let holdoutRunId;
+    let annotationsPath;
+    let keep = false;
+    let json = false;
+    for (let index = 1; index < argumentsList.length; index += 1) {
+        const argument = argumentsList[index];
+        const next = argumentsList[index + 1];
+        if (argument === "--registry" && next) {
+            registry = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--workspace" && next) {
+            workspace = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--project" && next) {
+            project = next;
+            index += 1;
+        }
+        else if (argument === "--candidate" && next) {
+            candidatePath = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--evidence" && next) {
+            evidencePath = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--dev-run" && next) {
+            devRunId = next;
+            index += 1;
+        }
+        else if (argument === "--holdout-run" && next) {
+            holdoutRunId = next;
+            index += 1;
+        }
+        else if (argument === "--annotations" && next) {
+            annotationsPath = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--stage" && next) {
+            const parsed = benchmarkStageSchema.safeParse(next);
+            if (!parsed.success)
+                throw new Error(`Unknown portfolio stage: ${next}`);
+            stage = parsed.data;
+            index += 1;
+        }
+        else if (argument === "--cohort" && (next === "development" || next === "holdout")) {
+            cohort = next;
+            index += 1;
+        }
+        else if (argument === "--run" && next) {
+            runId = next;
+            index += 1;
+        }
+        else if (argument === "--keep") {
+            keep = true;
+        }
+        else if (argument === "--json") {
+            json = true;
+        }
+        else if (argument === "--help" || argument === "-h") {
+            throw new Error("PORTFOLIO_HELP");
+        }
+        else {
+            throw new Error(`Unknown or incomplete portfolio argument: ${argument}`);
+        }
+    }
+    if (["snapshot", "capabilities", "run-stage", "baseline"].includes(parsedCommand) && !project) {
+        throw new Error(`${parsedCommand} requires --project ID`);
+    }
+    if (parsedCommand === "evaluate-rule" && !candidatePath) {
+        throw new Error("evaluate-rule requires --candidate PATH");
+    }
+    if (["evaluate-rule", "qualify-v3"].includes(parsedCommand) && !evidencePath) {
+        throw new Error(`${parsedCommand} requires --evidence PATH`);
+    }
+    if (!["evaluate-rule", "qualify-v3"].includes(parsedCommand) && evidencePath) {
+        throw new Error("--evidence applies only to evaluate-rule and qualify-v3");
+    }
+    if (parsedCommand === "run-stage" && !stage)
+        throw new Error("run-stage requires --stage STAGE");
+    if (parsedCommand !== "snapshot" && keep)
+        throw new Error("--keep applies only to the snapshot command");
+    if (parsedCommand !== "run-stage" && stage)
+        throw new Error("--stage applies only to the run-stage command");
+    if (["validate-registry", "inventory", "benchmark", "verify-unchanged", "report", "cross-product", "evaluate-rule", "qualify-v3"].includes(parsedCommand) && project) {
+        throw new Error("--project does not apply to this command");
+    }
+    if (parsedCommand === "benchmark" && !cohort)
+        throw new Error("benchmark requires --cohort development or holdout");
+    if (parsedCommand !== "benchmark" && cohort)
+        throw new Error("--cohort applies only to benchmark");
+    if (["verify-unchanged", "report", "prune-evidence", "cross-product"].includes(parsedCommand) && !runId)
+        throw new Error(`${parsedCommand} requires --run ID`);
+    if (!["baseline", "benchmark", "verify-unchanged", "report", "prune-evidence", "cross-product"].includes(parsedCommand) && runId)
+        throw new Error("--run does not apply to this command");
+    if (["baseline", "benchmark"].includes(parsedCommand) && !runId) {
+        runId = `run-${new Date().toISOString().replace(/[:.]/g, "-")}`;
+    }
+    return {
+        command: parsedCommand,
+        registry,
+        workspace,
+        ...(project ? { project } : {}),
+        ...(stage ? { stage } : {}),
+        ...(cohort ? { cohort } : {}),
+        ...(runId ? { runId } : {}),
+        ...(candidatePath ? { candidatePath } : {}),
+        ...(evidencePath ? { evidencePath } : {}),
+        ...(devRunId ? { devRunId } : {}),
+        ...(holdoutRunId ? { holdoutRunId } : {}),
+        ...(annotationsPath ? { annotationsPath } : {}),
+        keep,
+        json,
+        runRoot,
+    };
+}
+export async function runPortfolioCli(argumentsList, executable = "zz-design") {
+    if (argumentsList.length === 0 || argumentsList[0] === "--help" || argumentsList[0] === "-h") {
+        process.stdout.write(`${portfolioUsage(executable)}\n`);
+        return 0;
+    }
+    let options;
+    try {
+        options = parseArguments(argumentsList);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === "PORTFOLIO_HELP") {
+            process.stdout.write(`${portfolioUsage(executable)}\n`);
+            return 0;
+        }
+        throw error;
+    }
+    if (options.command === "report") {
+        const report = await readPortfolioBenchmarkReport(options.runRoot, options.runId);
+        process.stdout.write(`${JSON.stringify(report, null, options.json ? 2 : 2)}\n`);
+        return portfolioRunExitCode(report);
+    }
+    if (options.command === "prune-evidence") {
+        const result = await deleteProjectEvidence(options.runRoot, options.runId, options.project);
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        return 0;
+    }
+    if (options.command === "qualify-v3") {
+        const inspection = await inspectPortfolioRegistry(options.registry);
+        const evidenceInput = JSON.parse(await readFile(options.evidencePath, "utf8"));
+        const evidenceIntegrity = await verifyEvidenceReferences(process.cwd(), evidenceInput);
+        for (const failure of evidenceIntegrity.failures)
+            console.error(`[qualify-v3] ${failure}`);
+        let devReport;
+        let holdoutReport;
+        if (options.devRunId) {
+            devReport = await readPortfolioBenchmarkReport(options.runRoot, options.devRunId);
+        }
+        if (options.holdoutRunId) {
+            holdoutReport = await readPortfolioBenchmarkReport(options.runRoot, options.holdoutRunId);
+        }
+        const evidenceSemantics = await verifyQualificationEvidenceSemantics(process.cwd(), evidenceInput);
+        for (const failure of evidenceSemantics.failures)
+            console.error(`[qualify-v3] ${failure}`);
+        const report = evaluateV3Qualification(inspection, devReport, holdoutReport, evidenceInput, evidenceIntegrity.passed && evidenceSemantics.passed);
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        return report.passed ? 0 : 1;
+    }
+    if (options.command === "evaluate-rule") {
+        const candidateInput = JSON.parse(await readFile(options.candidatePath, "utf8"));
+        const evidenceInput = JSON.parse(await readFile(options.evidencePath, "utf8"));
+        const evidenceIntegrity = await verifyEvidenceReferences(process.cwd(), evidenceInput);
+        for (const failure of evidenceIntegrity.failures)
+            console.error(`[evaluate-rule] ${failure}`);
+        const inspection = await inspectPortfolioRegistry(options.registry);
+        let devReport;
+        let holdoutReport;
+        if (options.devRunId) {
+            devReport = await readPortfolioBenchmarkReport(options.runRoot, options.devRunId);
+        }
+        if (options.holdoutRunId) {
+            holdoutReport = await readPortfolioBenchmarkReport(options.runRoot, options.holdoutRunId);
+        }
+        const evidenceSemantics = await verifyRulePromotionEvidenceSemantics(process.cwd(), candidateInput, evidenceInput, holdoutReport);
+        for (const failure of evidenceSemantics.failures)
+            console.error(`[evaluate-rule] ${failure}`);
+        const report = evaluateRuleCandidate(candidateInput, inspection, devReport, holdoutReport, evidenceInput, evidenceIntegrity.passed && evidenceSemantics.passed);
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        return report.passed ? 0 : 1;
+    }
+    if (options.command === "cross-product") {
+        const report = await readPortfolioBenchmarkReport(options.runRoot, options.runId);
+        const inspection = await inspectPortfolioRegistry(options.registry);
+        let annotations = [];
+        if (options.annotationsPath) {
+            try {
+                const content = await readFile(options.annotationsPath, "utf8");
+                annotations = JSON.parse(content);
+            }
+            catch {
+                // empty annotations on read error
+            }
+        }
+        const evalReport = evaluateCrossProductTaxonomy(report, inspection.projects, annotations);
+        process.stdout.write(`${JSON.stringify(evalReport, null, 2)}\n`);
+        return evalReport.passed ? 0 : 1;
+    }
+    const inspection = await inspectPortfolioRegistry(options.registry);
+    if (options.command === "validate-registry") {
+        process.stdout.write(`${options.json ? JSON.stringify(inspection.report, null, 2) : formatPortfolioRegistryReport(inspection.report)}\n`);
+        return inspection.report.passed ? 0 : 1;
+    }
+    if (options.command === "inventory") {
+        const report = await discoverPortfolioCandidates(inspection);
+        process.stdout.write(`${options.json ? JSON.stringify(report, null, 2) : formatPortfolioInventoryReport(report)}\n`);
+        return report.passed ? 0 : 1;
+    }
+    if (!inspection.report.passed) {
+        process.stdout.write(`${options.json ? JSON.stringify(inspection.report, null, 2) : formatPortfolioRegistryReport(inspection.report)}\n`);
+        return 1;
+    }
+    if (options.command === "verify-unchanged") {
+        const verification = await verifyPortfolioRunSources(inspection, options.runRoot, options.runId);
+        process.stdout.write(`${JSON.stringify(verification, null, 2)}\n`);
+        return verification.unchanged ? 0 : 4;
+    }
+    if (options.command === "baseline" || options.command === "benchmark") {
+        const projects = options.command === "baseline"
+            ? [projectById(inspection, options.project)]
+            : inspection.projects.filter((entry) => entry.declaration.enabled && entry.declaration.cohort === options.cohort);
+        const execution = await runPortfolioBenchmark(inspection, {
+            runId: options.runId,
+            registryPath: options.registry,
+            workspaceRoot: options.workspace,
+            runRoot: options.runRoot,
+            mode: options.command === "baseline" ? "baseline" : "cohort",
+            ...(options.cohort ? { cohort: options.cohort } : {}),
+            projects,
+        });
+        process.stdout.write(`${JSON.stringify({ reportPath: execution.path, ...execution.report }, null, 2)}\n`);
+        return portfolioRunExitCode(execution.report);
+    }
+    const project = projectById(inspection, options.project);
+    if (options.command === "capabilities") {
+        const report = resolvePortfolioAdapter(project);
+        process.stdout.write(`${options.json ? JSON.stringify(report, null, 2) : formatPortfolioAdapterReport(report)}\n`);
+        return report.passed ? 0 : 1;
+    }
+    if (options.command === "run-stage") {
+        const execution = await withPortfolioSnapshot(project, options.workspace, (snapshot) => runPortfolioAdapterStage(snapshot, options.stage));
+        process.stdout.write(`${options.json ? JSON.stringify({ ...execution.result, snapshot: execution.summary }, null, 2) : formatPortfolioAdapterStageResult(execution.result)}\n`);
+        return ["passed", "unsupported", "not-applicable"].includes(execution.result.status) ? 0 : 1;
+    }
+    const snapshot = await createPortfolioSnapshot(project, options.workspace);
+    const summary = await closePortfolioSnapshot(snapshot, { keep: options.keep });
+    process.stdout.write(`${options.json ? JSON.stringify(summary, null, 2) : [
+        "# Portfolio Snapshot",
+        "",
+        `- Project: \`${summary.projectId}\``,
+        `- Source digest: \`${summary.sourceDigest}\``,
+        `- Source entries: ${summary.sourceEntries}`,
+        `- Copied files: ${summary.copiedFiles}`,
+        `- Copied bytes: ${summary.copiedBytes}`,
+        `- Source unchanged: ${summary.sourceUnchanged ? "yes" : "no"}`,
+        ...(summary.snapshotRoot ? [`- Snapshot: \`${summary.snapshotRoot}\``] : []),
+    ].join("\n")}\n`);
+    return 0;
+}
+//# sourceMappingURL=portfolio.js.map

package/dist/cli/portfolio.js.map

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

package/dist/cli/quality-gate.d.ts

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

package/dist/cli/quality-gate.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { formatQualityGateReport } from "../src/quality-gate/report.js";
+import { runQualityGate } from "../src/quality-gate/runner.js";
+function defaultOutputDirectory() {
+    return resolve(".ztothez-design-quality-gate", new Date().toISOString().replace(/[:.]/g, "-"));
+}
+function usage() {
+    return [
+        "Usage: npm run quality-gate -- --contract PATH --repo PATH --url URL --profile ID [options]",
+        "",
+        "Options:",
+        "  --project-root PATH          Root containing contract source files, default current directory",
+        "  --output PATH                Consolidated evidence directory",
+        "  --fail-on error|warning      Failure threshold, default error",
+        "  --attestations PATH          JSON or YAML manual-review attestations",
+        "  --skip-runtime               Run contract and architecture stages but report INCOMPLETE",
+        "  --json                       Print the consolidated JSON report",
+    ].join("\n");
+}
+function parseArguments(argumentsList) {
+    let contract = "";
+    let repository = "";
+    let projectRoot = process.cwd();
+    let outputDirectory = defaultOutputDirectory();
+    let url;
+    let profile;
+    let attestationsPath;
+    let failOn = "error";
+    let json = false;
+    let skipRuntime = 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 === "--repo" && next) {
+            repository = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--project-root" && next) {
+            projectRoot = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--output" && next) {
+            outputDirectory = resolve(next);
+            index += 1;
+        }
+        else if (argument === "--url" && next) {
+            url = next;
+            index += 1;
+        }
+        else if (argument === "--profile" && next) {
+            profile = next;
+            index += 1;
+        }
+        else if (argument === "--attestations" && next) {
+            attestationsPath = 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 === "--skip-runtime") {
+            skipRuntime = true;
+        }
+        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 (!repository)
+        throw new Error("--repo is required");
+    if (skipRuntime && (url || profile)) {
+        throw new Error("--skip-runtime cannot be combined with --url or --profile");
+    }
+    if (!skipRuntime && (!url || !profile)) {
+        throw new Error("--url and --profile are required unless --skip-runtime is used");
+    }
+    return {
+        contract,
+        repository,
+        projectRoot,
+        outputDirectory,
+        ...(url ? { url } : {}),
+        ...(profile ? { profile } : {}),
+        ...(attestationsPath ? { attestationsPath } : {}),
+        failOn,
+        json,
+    };
+}
+async function main() {
+    const options = parseArguments(process.argv.slice(2));
+    const report = await runQualityGate({
+        contractPath: options.contract,
+        projectRoot: options.projectRoot,
+        repository: options.repository,
+        outputDirectory: options.outputDirectory,
+        ...(options.url ? { url: options.url } : {}),
+        ...(options.profile ? { profile: options.profile } : {}),
+        ...(options.attestationsPath ? { attestationsPath: options.attestationsPath } : {}),
+        failOn: options.failOn,
+    });
+    process.stdout.write(`${options.json ? JSON.stringify(report, null, 2) : formatQualityGateReport(report)}\n`);
+    if (!report.passed && report.summary.errors > 0)
+        process.exitCode = 1;
+    else 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 failed to execute: ${message}\n\n${usage()}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=quality-gate.js.map