@ztothez/design-engineering 2.0.0

package/dist/src/contracts/schema.js

@@ -0,0 +1,385 @@
+import { z } from "zod";
+import { runtimeExpectedNetworkSchema, runtimeJourneySchema, runtimeViewportSchema, } from "../runtime/schema.js";
+const idSchema = z.string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/);
+const relativePathSchema = z.string().trim().min(1).max(1_024);
+const sourceSchema = z
+    .object({
+    path: relativePathSchema,
+    role: z.string().trim().min(1).max(256),
+    authority: z.enum(["primary", "supporting", "historical"]),
+})
+    .strict();
+const actorSchema = z
+    .object({
+    id: idSchema,
+    name: z.string().trim().min(1).max(128),
+    goals: z.array(z.string().trim().min(1).max(512)).min(1),
+    responsibilities: z.array(z.string().trim().min(1).max(512)).min(1),
+})
+    .strict();
+const modeSchema = z
+    .object({
+    id: idSchema,
+    name: z.string().trim().min(1).max(128),
+    purpose: z.string().trim().min(1).max(1_024),
+    input: z.string().trim().min(1).max(512),
+    outputs: z.array(idSchema).min(1),
+})
+    .strict();
+const stateMachineSchema = z
+    .object({
+    id: idSchema,
+    initial: idSchema,
+    states: z
+        .array(z
+        .object({
+        id: idSchema,
+        category: z.enum(["idle", "loading", "success", "error", "fallback", "terminal"]),
+        userVisible: z.boolean(),
+        requirement: z.string().trim().min(1).max(1_024),
+    })
+        .strict())
+        .min(2),
+    transitions: z
+        .array(z
+        .object({
+        from: idSchema,
+        to: idSchema,
+        trigger: z.string().trim().min(1).max(256),
+    })
+        .strict())
+        .min(1),
+})
+    .strict();
+const outputSchema = z
+    .object({
+    id: idSchema,
+    name: z.string().trim().min(1).max(128),
+    sourceOfTruth: z.string().trim().min(1).max(512),
+    requiredEvidence: z.array(z.string().trim().min(1).max(256)).min(1),
+})
+    .strict();
+const metricSchema = z
+    .object({
+    id: idSchema,
+    name: z.string().trim().min(1).max(128),
+    definition: z.string().trim().min(1).max(1_024),
+    sourceOfTruth: z.string().trim().min(1).max(512),
+    format: z.enum(["percentage", "duration", "count", "status", "text"]),
+    evidenceRequired: z.boolean(),
+    range: z
+        .object({ min: z.number(), max: z.number() })
+        .strict()
+        .refine((range) => range.min <= range.max, "Metric range min must not exceed max")
+        .optional(),
+})
+    .strict();
+const acceptanceCriterionSchema = z
+    .object({
+    id: idSchema,
+    title: z.string().trim().min(1).max(160),
+    severity: z.enum(["blocker", "warning"]),
+    requirement: z.string().trim().min(1).max(2_048),
+    evidence: z
+        .array(z.enum([
+        "contract",
+        "runtime",
+        "screenshot",
+        "network",
+        "accessibility",
+        "export",
+        "manual-review",
+    ]))
+        .min(1),
+    appliesToModes: z.array(idSchema).min(1),
+})
+    .strict();
+const journeyBindingSchema = z
+    .object({
+    profile: idSchema,
+    journey: idSchema,
+    actor: idSchema,
+    mode: idSchema,
+    acceptanceCriteria: z.array(idSchema).min(1),
+})
+    .strict();
+export const productArchetypeSchema = z.enum([
+    "operational-dashboard",
+    "ai-workspace",
+    "content-site",
+    "utility",
+    "full-stack-workflow",
+]);
+export const productQualityDimensionSchema = z.enum([
+    "truthful-disclosure",
+    "information-design",
+    "visual-system",
+    "accessibility",
+    "responsive-structure",
+    "state-integrity",
+    "maintainability",
+]);
+const taskStateSchema = z
+    .object({
+    stateMachine: idSchema,
+    state: idSchema,
+    observable: z.string().trim().min(1).max(1_024),
+})
+    .strict();
+const productTaskSchema = z
+    .object({
+    id: idSchema,
+    primary: z.boolean(),
+    actor: idSchema,
+    mode: idSchema,
+    intent: z.string().trim().min(1).max(1_024),
+    start: taskStateSchema,
+    success: taskStateSchema.extend({
+        evidence: z
+            .array(z.enum(["contract", "runtime", "network", "export", "manual-review"]))
+            .min(1),
+    }),
+    recovery: z
+        .object({
+        required: z.boolean(),
+        failure: taskStateSchema,
+        observable: z.string().trim().min(1).max(1_024),
+    })
+        .strict(),
+    journey: z
+        .object({
+        profile: idSchema,
+        journey: idSchema,
+    })
+        .strict()
+        .optional(),
+    browser: z
+        .object({
+        route: z.string().regex(/^\/(?!\/)/).max(1_024),
+        narrowViewport: z.string().trim().min(1).max(128),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+export const productTaskProfileSchema = z
+    .object({
+    archetype: productArchetypeSchema,
+    interface: z.enum(["browser", "desktop", "source-only"]),
+    qualityDimensions: z
+        .array(z
+        .object({
+        id: productQualityDimensionSchema,
+        status: z.enum(["required", "not-applicable"]),
+        reason: z.string().trim().min(1).max(512),
+    })
+        .strict())
+        .length(productQualityDimensionSchema.options.length),
+    tasks: z.array(productTaskSchema).min(1).max(50),
+    evidencePolicy: z
+        .object({
+        missingEvidence: z.literal("unverified"),
+        failedBehavior: z.literal("failed"),
+        unsupportedCapability: z.literal("limitation"),
+    })
+        .strict(),
+    comparison: z
+        .object({
+        taskContractId: idSchema,
+        crossContractRanking: z.literal(false),
+    })
+        .strict(),
+})
+    .strict()
+    .superRefine((profile, context) => {
+    const dimensionIds = profile.qualityDimensions.map((dimension) => dimension.id);
+    if (new Set(dimensionIds).size !== dimensionIds.length) {
+        context.addIssue({
+            code: "custom",
+            path: ["qualityDimensions"],
+            message: "Quality dimensions must be unique.",
+        });
+    }
+    const missingDimensions = productQualityDimensionSchema.options.filter((dimension) => !dimensionIds.includes(dimension));
+    if (missingDimensions.length > 0) {
+        context.addIssue({
+            code: "custom",
+            path: ["qualityDimensions"],
+            message: `Missing quality dimensions: ${missingDimensions.join(", ")}.`,
+        });
+    }
+    if (!profile.tasks.some((task) => task.primary)) {
+        context.addIssue({
+            code: "custom",
+            path: ["tasks"],
+            message: "At least one primary product task is required.",
+        });
+    }
+    if (!profile.tasks.some((task) => task.recovery.required)) {
+        context.addIssue({
+            code: "custom",
+            path: ["tasks"],
+            message: "At least one task must require an observable failure or recovery path.",
+        });
+    }
+    for (const [index, task] of profile.tasks.entries()) {
+        if (profile.interface === "browser" && (!task.browser || !task.journey)) {
+            context.addIssue({
+                code: "custom",
+                path: ["tasks", index],
+                message: "Browser tasks require both browser and journey declarations.",
+            });
+        }
+        if (profile.interface === "source-only" && task.browser) {
+            context.addIssue({
+                code: "custom",
+                path: ["tasks", index, "browser"],
+                message: "Source-only tasks cannot claim a browser route or viewport.",
+            });
+        }
+    }
+});
+const baseProductContractFields = {
+    id: idSchema,
+    name: z.string().trim().min(1).max(160),
+    status: z.enum(["draft", "benchmark", "production"]),
+    purpose: z.string().trim().min(1).max(2_048),
+    authority: z
+        .object({
+        behavior: z.string().trim().min(1).max(512),
+        visual: z.string().trim().min(1).max(512),
+        precedence: z.array(sourceSchema).min(1),
+    })
+        .strict(),
+    actors: z.array(actorSchema).min(1),
+    modes: z.array(modeSchema).min(1),
+    stateMachines: z.array(stateMachineSchema).min(1),
+    outputs: z.array(outputSchema).min(1),
+    metrics: z.array(metricSchema).min(1),
+    constraints: z
+        .object({
+        outOfScope: z.array(z.string().trim().min(1).max(512)).min(1),
+        prohibitedClaims: z.array(z.string().trim().min(1).max(512)).min(1),
+        mockData: z
+            .object({
+            allowedEnvironments: z.array(z.enum(["development", "test", "demo"])).min(1),
+            mustBeLabeled: z.boolean(),
+            prohibitedInProduction: z.boolean(),
+            fallbackDisclosure: z.string().trim().min(1).max(1_024),
+        })
+            .strict(),
+    })
+        .strict(),
+    acceptanceCriteria: z.array(acceptanceCriterionSchema).min(1),
+    verification: z
+        .object({
+        journeyFile: relativePathSchema,
+        viewports: z.array(runtimeViewportSchema).min(1).max(8),
+        bindings: z.array(journeyBindingSchema).min(1),
+    })
+        .strict(),
+};
+const legacyProductContractSchema = z
+    .object({ version: z.literal("1.0"), ...baseProductContractFields })
+    .strict();
+const benchmarkProductContractSchema = z
+    .object({
+    version: z.literal("1.1"),
+    ...baseProductContractFields,
+    benchmark: productTaskProfileSchema,
+})
+    .strict();
+const interactionProductContractSchema = z
+    .object({
+    version: z.literal("1.2"),
+    ...baseProductContractFields,
+    benchmark: productTaskProfileSchema,
+})
+    .strict();
+export const productContractSchema = z.discriminatedUnion("version", [
+    legacyProductContractSchema,
+    benchmarkProductContractSchema,
+    interactionProductContractSchema,
+]);
+export const journeyProfileSchema = z
+    .object({
+    id: idSchema,
+    name: z.string().trim().min(1).max(160),
+    environment: z.array(z.string().trim().min(1).max(512)).min(1),
+    expectedNetwork: z.array(runtimeExpectedNetworkSchema).max(20).optional(),
+    journeys: z.array(runtimeJourneySchema.extend({ id: idSchema })).min(1),
+})
+    .strict()
+    .superRefine((profile, context) => {
+    const ids = profile.expectedNetwork?.map((policy) => policy.id) ?? [];
+    if (new Set(ids).size !== ids.length) {
+        context.addIssue({ code: "custom", path: ["expectedNetwork"], message: "Policy IDs must be unique" });
+    }
+});
+export const journeySuiteSchema = z
+    .discriminatedUnion("version", [
+    z
+        .object({
+        version: z.literal("1.0"),
+        contract: idSchema,
+        profiles: z.array(journeyProfileSchema).min(1),
+    })
+        .strict(),
+    z
+        .object({
+        version: z.literal("1.1"),
+        contract: idSchema,
+        profiles: z.array(journeyProfileSchema).min(1),
+    })
+        .strict()
+        .superRefine((suite, context) => {
+        for (const [profileIndex, profile] of suite.profiles.entries()) {
+            for (const [journeyIndex, journey] of profile.journeys.entries()) {
+                if (!journey.interaction) {
+                    context.addIssue({
+                        code: "custom",
+                        path: ["profiles", profileIndex, "journeys", journeyIndex, "interaction"],
+                        message: "V1.1 journey suites require interaction coverage for every journey",
+                    });
+                }
+            }
+        }
+    }),
+]);
+export const contractIssueSchema = z
+    .object({
+    code: z.string(),
+    path: z.string(),
+    message: z.string(),
+})
+    .strict();
+export const contractValidationReportSchema = {
+    version: z.string(),
+    contractPath: z.string(),
+    journeyPath: z.string().optional(),
+    generatedAt: z.string(),
+    contractId: z.string().optional(),
+    counts: z.object({
+        actors: z.number().int().nonnegative(),
+        modes: z.number().int().nonnegative(),
+        acceptanceCriteria: z.number().int().nonnegative(),
+        journeyProfiles: z.number().int().nonnegative(),
+        journeys: z.number().int().nonnegative(),
+    }),
+    taskModel: z.object({
+        status: z.enum(["ready", "legacy", "invalid"]),
+        archetype: productArchetypeSchema.optional(),
+        primaryTasks: z.number().int().nonnegative(),
+        recoveryTasks: z.number().int().nonnegative(),
+        narrowViewportTasks: z.number().int().nonnegative(),
+        evidencePolicy: z.object({
+            missingEvidence: z.literal("unverified"),
+            failedBehavior: z.literal("failed"),
+            unsupportedCapability: z.literal("limitation"),
+        }),
+    }),
+    limitations: z.array(z.string()),
+    issues: z.array(contractIssueSchema),
+    passed: z.boolean(),
+};
+//# sourceMappingURL=schema.js.map

package/dist/src/contracts/schema.js.map

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

package/dist/src/contracts/validator.d.ts

@@ -0,0 +1,12 @@
+import { type ContractValidationReport, type JourneySuite, type ProductContract } from "./schema.js";
+export type ValidationOptions = {
+    projectRoot?: string;
+};
+export type ContractInspection = {
+    report: ContractValidationReport;
+    contract?: ProductContract;
+    suite?: JourneySuite;
+    journeyPath?: string;
+};
+export declare function inspectProductContract(requestedContractPath: string, options?: ValidationOptions): Promise<ContractInspection>;
+export declare function validateProductContract(requestedContractPath: string, options?: ValidationOptions): Promise<ContractValidationReport>;