@ztothez/design-engineering 2.0.0

package/dist/src/product-brief/schema.js

@@ -0,0 +1,272 @@
+import { z } from "zod";
+const idSchema = z.string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/);
+const text = (maximum) => z.string().trim().min(1).max(maximum);
+const textList = (maximumItems, maximumLength = 512) => z.array(text(maximumLength)).max(maximumItems);
+export const evidenceKindSchema = z.enum([
+    "user-provided",
+    "stakeholder",
+    "user-research",
+    "product-analytics",
+    "support-record",
+    "existing-product",
+    "technical-source",
+    "public-standard",
+    "agent-assumption",
+]);
+const evidenceSourceSchema = z
+    .object({
+    id: idSchema,
+    kind: evidenceKindSchema,
+    description: text(1_024),
+    location: text(1_024).optional(),
+    owner: text(256),
+})
+    .strict();
+const audienceSchema = z
+    .object({
+    id: idSchema,
+    role: text(256),
+    priority: z.enum(["primary", "secondary", "affected"]),
+    goals: textList(20),
+    contexts: textList(20),
+    constraints: textList(20),
+    accessibilityNeeds: textList(20),
+    expertise: z.enum(["novice", "intermediate", "expert", "mixed", "unknown"]),
+    evidenceRefs: z.array(idSchema).min(1).max(50),
+})
+    .strict();
+const measurableBaselineSchema = z.discriminatedUnion("status", [
+    z.object({ status: z.literal("known"), value: text(256) }).strict(),
+    z.object({ status: z.literal("unknown"), reason: text(512) }).strict(),
+    z.object({ status: z.literal("not-applicable"), reason: text(512) }).strict(),
+]);
+const outcomeSchema = z
+    .object({
+    id: idSchema,
+    kind: z.enum(["user", "business", "operational", "risk-reduction"]),
+    statement: text(1_024),
+    measure: z
+        .object({
+        signal: text(512),
+        baseline: measurableBaselineSchema,
+        target: text(512),
+    })
+        .strict(),
+    evidenceRefs: z.array(idSchema).min(1).max(50),
+})
+    .strict();
+export const dataModeSchema = z.enum([
+    "live",
+    "demo",
+    "hybrid",
+    "imported",
+    "cached",
+    "user-input",
+    "local-static",
+]);
+const dataSourceSchema = z
+    .object({
+    id: idSchema,
+    name: text(256),
+    mode: dataModeSchema,
+    latency: z.enum(["immediate", "async", "streaming", "unknown"]),
+    classification: z.enum(["public", "internal", "confidential", "restricted"]),
+    sourceEvidenceRef: idSchema,
+    freshness: text(512),
+    limitations: textList(20),
+    fallback: z
+        .object({
+        kind: z.enum(["none", "demo", "cache", "import", "manual"]),
+        disclosure: text(512),
+        preservesOrigin: z.boolean(),
+    })
+        .strict(),
+})
+    .strict();
+const taskSchema = z
+    .object({
+    id: idSchema,
+    title: text(256),
+    audienceRefs: z.array(idSchema).min(1).max(20),
+    outcomeRefs: z.array(idSchema).min(1).max(20),
+    dataRefs: z.array(idSchema).max(50),
+    trigger: text(512),
+    goal: text(1_024),
+    frequency: z.enum(["continuous", "daily", "weekly", "monthly", "occasional", "one-time"]),
+    criticality: z.enum(["critical", "high", "medium", "low"]),
+    consequential: z.boolean(),
+    inputs: textList(30),
+    successSignal: text(1_024),
+    failureImpact: text(1_024),
+    recovery: text(1_024),
+    evidenceRefs: z.array(idSchema).min(1).max(50),
+})
+    .strict();
+export const interfaceStateSchema = z.enum([
+    "loading",
+    "empty",
+    "success",
+    "error",
+    "partial",
+    "stale",
+    "disconnected",
+    "unauthorized",
+    "blocked",
+    "offline",
+]);
+const stateSchema = z
+    .object({
+    state: interfaceStateSchema,
+    taskRefs: z.array(idSchema).min(1).max(100),
+    behavior: text(1_024),
+    recovery: text(1_024),
+    disclosure: text(1_024),
+})
+    .strict();
+const platformSchema = z
+    .object({
+    id: idSchema,
+    kind: z.enum(["responsive-web", "desktop-web", "mobile-web", "native-mobile", "desktop-app"]),
+    priority: z.enum(["primary", "secondary"]),
+    viewports: z.array(z.number().int().min(240).max(10_000)).max(20),
+    inputModes: z.array(z.enum(["keyboard", "pointer", "touch", "assistive-technology"])).min(1),
+    constraints: textList(20),
+})
+    .strict();
+const requirementSchema = z
+    .object({
+    id: idSchema,
+    category: z.enum([
+        "functional",
+        "usability",
+        "accessibility",
+        "security",
+        "privacy",
+        "performance",
+        "reliability",
+        "maintainability",
+        "content",
+        "brand",
+    ]),
+    priority: z.enum(["must", "should", "could", "wont"]),
+    statement: text(1_024),
+    rationale: text(1_024),
+    taskRefs: z.array(idSchema).max(100),
+    evidenceRefs: z.array(idSchema).min(1).max(100),
+})
+    .strict();
+const assumptionSchema = z
+    .object({
+    id: idSchema,
+    statement: text(1_024),
+    risk: z.enum(["high", "medium", "low"]),
+    status: z.enum(["unresolved", "validated", "rejected"]),
+    evidenceRefs: z.array(idSchema).max(100),
+    validationMethod: text(1_024),
+})
+    .strict();
+export const briefVerificationMethodSchema = z.enum([
+    "static-analysis",
+    "unit-test",
+    "integration-test",
+    "browser-test",
+    "manual-human",
+    "human-expert",
+    "representative-user",
+]);
+const acceptanceCriterionSchema = z
+    .object({
+    id: idSchema,
+    statement: text(1_024),
+    requirementRefs: z.array(idSchema).min(1).max(100),
+    taskRefs: z.array(idSchema).min(1).max(100),
+    method: briefVerificationMethodSchema,
+    expectedEvidence: text(1_024),
+    blocking: z.boolean(),
+})
+    .strict();
+const downstreamContractSchema = z
+    .object({
+    kind: z.enum(["product-task", "interface-trust", "information-design", "design-deliverable"]),
+    status: z.enum(["planned", "exists", "not-applicable"]),
+    path: text(1_024).optional(),
+    reason: text(1_024).optional(),
+})
+    .strict()
+    .superRefine((entry, context) => {
+    if (entry.status === "exists" && !entry.path) {
+        context.addIssue({ code: "custom", path: ["path"], message: "Existing downstream contracts require a path." });
+    }
+    if (entry.status === "not-applicable" && !entry.reason) {
+        context.addIssue({ code: "custom", path: ["reason"], message: "Not-applicable downstream contracts require a reason." });
+    }
+});
+export const productDesignBriefSchema = z
+    .object({
+    version: z.literal("1.0"),
+    id: idSchema,
+    product: text(256),
+    status: z.enum(["draft", "validated"]),
+    preparedAt: z.string().datetime({ offset: true }),
+    preparedBy: z.object({ type: z.enum(["agent", "human", "mixed"]), name: text(256) }).strict(),
+    evidenceSources: z.array(evidenceSourceSchema).min(1).max(500),
+    problem: z
+        .object({
+        statement: text(1_024),
+        currentOutcome: text(1_024),
+        desiredOutcome: text(1_024),
+        evidenceRefs: z.array(idSchema).min(1).max(100),
+    })
+        .strict(),
+    scope: z.object({ included: textList(100).min(1), excluded: textList(100).min(1) }).strict(),
+    audiences: z.array(audienceSchema).min(1).max(100),
+    outcomes: z.array(outcomeSchema).min(1).max(200),
+    dataSources: z.array(dataSourceSchema).min(1).max(500),
+    tasks: z.array(taskSchema).min(1).max(500),
+    states: z.array(stateSchema).min(1).max(20),
+    platforms: z.array(platformSchema).min(1).max(20),
+    constraints: textList(100, 1_024),
+    requirements: z.array(requirementSchema).min(1).max(1_000),
+    assumptions: z.array(assumptionSchema).max(500),
+    acceptanceCriteria: z.array(acceptanceCriterionSchema).min(1).max(2_000),
+    downstreamContracts: z.array(downstreamContractSchema).length(4),
+})
+    .strict();
+export const productBriefFindingSchema = z
+    .object({
+    ruleId: z.string().regex(/^ZTDE-BRIEF-[0-9]{3}$/),
+    severity: z.enum(["error", "warning", "info"]),
+    path: z.string(),
+    message: z.string(),
+    remediation: z.string(),
+})
+    .strict();
+export const productBriefReportSchema = z
+    .object({
+    version: z.string(),
+    generatedAt: z.string(),
+    sourcePath: z.string(),
+    briefId: z.string(),
+    product: z.string(),
+    findings: z.array(productBriefFindingSchema),
+    coverage: z
+        .object({
+        evidenceSources: z.number().int().nonnegative(),
+        audiences: z.number().int().nonnegative(),
+        primaryAudiences: z.number().int().nonnegative(),
+        outcomes: z.number().int().nonnegative(),
+        tasks: z.number().int().nonnegative(),
+        dataSources: z.number().int().nonnegative(),
+        states: z.number().int().nonnegative(),
+        platforms: z.number().int().nonnegative(),
+        requirements: z.number().int().nonnegative(),
+        acceptanceCriteria: z.number().int().nonnegative(),
+    })
+        .strict(),
+    summary: z.object({ errors: z.number().int().nonnegative(), warnings: z.number().int().nonnegative(), info: z.number().int().nonnegative() }).strict(),
+    passed: z.boolean(),
+    generationReady: z.boolean(),
+    limitations: z.array(z.string()),
+})
+    .strict();
+//# sourceMappingURL=schema.js.map

package/dist/src/product-brief/schema.js.map

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

package/dist/src/product-brief/validator.d.ts

@@ -0,0 +1,2 @@
+import type { ProductDesignBrief, ProductBriefReport } from "./schema.js";
+export declare function validateProductDesignBrief(brief: ProductDesignBrief, sourcePath: string): ProductBriefReport;

package/dist/src/product-brief/validator.js

@@ -0,0 +1,251 @@
+import { basename } from "node:path";
+const REPORT_VERSION = "1.0.0";
+const DOWNSTREAM_KINDS = [
+    "product-task",
+    "interface-trust",
+    "information-design",
+    "design-deliverable",
+];
+const PLACEHOLDER_PATTERN = /\b(?:todo|tbd|placeholder|lorem ipsum|unknown user|generic user|user persona)\b/i;
+function addFinding(findings, ruleId, severity, path, message, remediation) {
+    findings.push({ ruleId, severity, path, message, remediation });
+}
+function duplicates(values) {
+    const seen = new Set();
+    const repeated = new Set();
+    for (const value of values) {
+        if (seen.has(value))
+            repeated.add(value);
+        seen.add(value);
+    }
+    return [...repeated].sort();
+}
+function normalizedScope(value) {
+    return value.trim().toLowerCase().replace(/\s+/g, " ");
+}
+export function validateProductDesignBrief(brief, sourcePath) {
+    const findings = [];
+    const evidence = new Map(brief.evidenceSources.map((entry) => [entry.id, entry]));
+    const audiences = new Map(brief.audiences.map((entry) => [entry.id, entry]));
+    const outcomes = new Map(brief.outcomes.map((entry) => [entry.id, entry]));
+    const dataSources = new Map(brief.dataSources.map((entry) => [entry.id, entry]));
+    const tasks = new Map(brief.tasks.map((entry) => [entry.id, entry]));
+    const requirements = new Map(brief.requirements.map((entry) => [entry.id, entry]));
+    const identifierCollections = [
+        ["evidenceSources", brief.evidenceSources.map((entry) => entry.id)],
+        ["audiences", brief.audiences.map((entry) => entry.id)],
+        ["outcomes", brief.outcomes.map((entry) => entry.id)],
+        ["dataSources", brief.dataSources.map((entry) => entry.id)],
+        ["tasks", brief.tasks.map((entry) => entry.id)],
+        ["platforms", brief.platforms.map((entry) => entry.id)],
+        ["requirements", brief.requirements.map((entry) => entry.id)],
+        ["assumptions", brief.assumptions.map((entry) => entry.id)],
+        ["acceptanceCriteria", brief.acceptanceCriteria.map((entry) => entry.id)],
+    ];
+    for (const [path, ids] of identifierCollections) {
+        for (const duplicate of duplicates(ids)) {
+            addFinding(findings, "ZTDE-BRIEF-001", "error", path, `Duplicate identifier: ${duplicate}.`, "Give every record a stable unique identifier within its collection.");
+        }
+    }
+    const checkRefs = (refs, target, path, owner, kind) => {
+        for (const [index, ref] of refs.entries()) {
+            if (!target.has(ref)) {
+                addFinding(findings, "ZTDE-BRIEF-101", "error", `${path}[${index}]`, `${owner} references missing ${kind} ${ref}.`, `Add the ${kind} or correct the reference.`);
+            }
+        }
+    };
+    checkRefs(brief.problem.evidenceRefs, evidence, "problem.evidenceRefs", "Problem statement", "evidence source");
+    for (const [index, audience] of brief.audiences.entries()) {
+        checkRefs(audience.evidenceRefs, evidence, `audiences[${index}].evidenceRefs`, `Audience ${audience.id}`, "evidence source");
+    }
+    for (const [index, outcome] of brief.outcomes.entries()) {
+        checkRefs(outcome.evidenceRefs, evidence, `outcomes[${index}].evidenceRefs`, `Outcome ${outcome.id}`, "evidence source");
+    }
+    for (const [index, source] of brief.dataSources.entries()) {
+        checkRefs([source.sourceEvidenceRef], evidence, `dataSources[${index}].sourceEvidenceRef`, `Data source ${source.id}`, "evidence source");
+    }
+    for (const [index, task] of brief.tasks.entries()) {
+        checkRefs(task.audienceRefs, audiences, `tasks[${index}].audienceRefs`, `Task ${task.id}`, "audience");
+        checkRefs(task.outcomeRefs, outcomes, `tasks[${index}].outcomeRefs`, `Task ${task.id}`, "outcome");
+        checkRefs(task.dataRefs, dataSources, `tasks[${index}].dataRefs`, `Task ${task.id}`, "data source");
+        checkRefs(task.evidenceRefs, evidence, `tasks[${index}].evidenceRefs`, `Task ${task.id}`, "evidence source");
+    }
+    for (const [index, state] of brief.states.entries()) {
+        checkRefs(state.taskRefs, tasks, `states[${index}].taskRefs`, `State ${state.state}`, "task");
+    }
+    for (const [index, requirement] of brief.requirements.entries()) {
+        checkRefs(requirement.taskRefs, tasks, `requirements[${index}].taskRefs`, `Requirement ${requirement.id}`, "task");
+        checkRefs(requirement.evidenceRefs, evidence, `requirements[${index}].evidenceRefs`, `Requirement ${requirement.id}`, "evidence source");
+    }
+    for (const [index, assumption] of brief.assumptions.entries()) {
+        checkRefs(assumption.evidenceRefs, evidence, `assumptions[${index}].evidenceRefs`, `Assumption ${assumption.id}`, "evidence source");
+    }
+    for (const [index, criterion] of brief.acceptanceCriteria.entries()) {
+        checkRefs(criterion.requirementRefs, requirements, `acceptanceCriteria[${index}].requirementRefs`, `Acceptance criterion ${criterion.id}`, "requirement");
+        checkRefs(criterion.taskRefs, tasks, `acceptanceCriteria[${index}].taskRefs`, `Acceptance criterion ${criterion.id}`, "task");
+    }
+    const primaryAudiences = brief.audiences.filter((entry) => entry.priority === "primary");
+    if (primaryAudiences.length === 0) {
+        addFinding(findings, "ZTDE-BRIEF-201", "error", "audiences", "The brief has no primary audience.", "Declare at least one primary audience whose task and constraints drive generation.");
+    }
+    for (const audience of primaryAudiences) {
+        const supported = audience.evidenceRefs.some((ref) => evidence.get(ref)?.kind !== "agent-assumption");
+        if (!supported || audience.goals.length === 0 || audience.contexts.length === 0) {
+            addFinding(findings, "ZTDE-BRIEF-201", "error", `audiences.${audience.id}`, `Primary audience ${audience.id} lacks non-agent evidence, goals, or usage context.`, "Ground the primary audience in user-provided or observed evidence and declare concrete goals and contexts.");
+        }
+    }
+    if (!brief.problem.evidenceRefs.some((ref) => evidence.get(ref)?.kind !== "agent-assumption")) {
+        addFinding(findings, "ZTDE-BRIEF-202", "error", "problem.evidenceRefs", "The product problem is supported only by an agent assumption.", "Add user-provided, stakeholder, research, analytics, support, existing-product, or technical evidence.");
+    }
+    const excluded = new Set(brief.scope.excluded.map(normalizedScope));
+    for (const [index, item] of brief.scope.included.entries()) {
+        if (excluded.has(normalizedScope(item))) {
+            addFinding(findings, "ZTDE-BRIEF-203", "error", `scope.included[${index}]`, `Scope item ${JSON.stringify(item)} is both included and excluded.`, "Resolve the scope conflict before planning implementation.");
+        }
+    }
+    for (const [index, task] of brief.tasks.entries()) {
+        if (!task.audienceRefs.some((ref) => audiences.get(ref)?.priority === "primary")) {
+            addFinding(findings, "ZTDE-BRIEF-301", "warning", `tasks[${index}].audienceRefs`, `Task ${task.id} is not linked to a primary audience.`, "Link the task to a primary audience or explain why it is secondary work.");
+        }
+        if (["critical", "high"].includes(task.criticality) && (!task.failureImpact.trim() || !task.recovery.trim())) {
+            addFinding(findings, "ZTDE-BRIEF-302", "error", `tasks[${index}]`, `High-impact task ${task.id} has no concrete failure impact or recovery.`, "Declare what failure costs and how the user preserves work, retries, or reaches support.");
+        }
+        if (task.consequential && task.dataRefs.length === 0) {
+            addFinding(findings, "ZTDE-BRIEF-303", "error", `tasks[${index}].dataRefs`, `Consequential task ${task.id} has no declared data boundary.`, "Reference the data used for the decision or action, including local or user-entered data.");
+        }
+    }
+    for (const [index, source] of brief.dataSources.entries()) {
+        const evidenceSource = evidence.get(source.sourceEvidenceRef);
+        if (["live", "hybrid"].includes(source.mode) && evidenceSource?.kind === "agent-assumption") {
+            addFinding(findings, "ZTDE-BRIEF-401", "error", `dataSources[${index}].sourceEvidenceRef`, `Data source ${source.id} claims ${source.mode} behavior from agent-authored evidence.`, "Ground live behavior in a user-provided or technical source and leave connection unknown until runtime verification.");
+        }
+        if ((["demo", "hybrid"].includes(source.mode) || source.fallback.kind === "demo") && !/(?:demo|simulat)/i.test(source.fallback.disclosure)) {
+            addFinding(findings, "ZTDE-BRIEF-402", "error", `dataSources[${index}].fallback.disclosure`, `Data source ${source.id} can show demonstration data without an explicit demo or simulation disclosure.`, "State plainly when data is demonstration or simulated and preserve that origin in results and exports.");
+        }
+        if (source.fallback.kind !== "none" && !source.fallback.preservesOrigin) {
+            addFinding(findings, "ZTDE-BRIEF-402", "error", `dataSources[${index}].fallback.preservesOrigin`, `Fallback for ${source.id} does not preserve result origin.`, "Keep fallback origin visible through loading, result, history, and export states.");
+        }
+    }
+    const declaredStates = new Set(brief.states.map((entry) => entry.state));
+    const requiredStates = new Set(["empty", "success", "error"]);
+    if (brief.dataSources.some((entry) => ["async", "streaming", "unknown"].includes(entry.latency)))
+        requiredStates.add("loading");
+    if (brief.dataSources.some((entry) => ["live", "hybrid", "cached"].includes(entry.mode)))
+        requiredStates.add("stale");
+    if (brief.dataSources.length > 1 || brief.dataSources.some((entry) => entry.mode === "hybrid" || entry.latency === "streaming"))
+        requiredStates.add("partial");
+    if (brief.dataSources.some((entry) => ["live", "hybrid"].includes(entry.mode) || entry.latency === "streaming"))
+        requiredStates.add("disconnected");
+    if (brief.dataSources.some((entry) => ["confidential", "restricted"].includes(entry.classification)))
+        requiredStates.add("unauthorized");
+    for (const state of requiredStates) {
+        if (!declaredStates.has(state)) {
+            addFinding(findings, "ZTDE-BRIEF-501", "error", "states", `Applicable interface state ${state} is missing.`, "Declare its visible behavior, disclosure, affected tasks, and recovery before generation.");
+        }
+    }
+    for (const duplicate of duplicates(brief.states.map((entry) => entry.state))) {
+        addFinding(findings, "ZTDE-BRIEF-001", "error", "states", `Duplicate interface state: ${duplicate}.`, "Define one coherent contract per interface state.");
+    }
+    for (const [index, platform] of brief.platforms.entries()) {
+        if (platform.kind === "responsive-web") {
+            for (const viewport of [375, 768, 1024, 1440]) {
+                if (!platform.viewports.includes(viewport)) {
+                    addFinding(findings, "ZTDE-BRIEF-502", "error", `platforms[${index}].viewports`, `Responsive platform ${platform.id} omits ${viewport} CSS pixels.`, "Declare all four maintained responsive verification widths.");
+                }
+            }
+            for (const input of ["keyboard", "pointer", "touch", "assistive-technology"]) {
+                if (!platform.inputModes.includes(input)) {
+                    addFinding(findings, "ZTDE-BRIEF-502", "error", `platforms[${index}].inputModes`, `Responsive platform ${platform.id} omits ${input} operation.`, "Declare the supported responsive input and accessibility modes before generation.");
+                }
+            }
+        }
+    }
+    for (const [index, assumption] of brief.assumptions.entries()) {
+        if (assumption.status === "unresolved" && assumption.risk === "high") {
+            addFinding(findings, "ZTDE-BRIEF-601", "error", `assumptions[${index}]`, `High-risk assumption ${assumption.id} remains unresolved.`, "Validate, reject, or reduce the assumption before generation.");
+        }
+        else if (assumption.status === "unresolved" && assumption.risk === "medium") {
+            addFinding(findings, "ZTDE-BRIEF-601", "warning", `assumptions[${index}]`, `Medium-risk assumption ${assumption.id} remains unresolved.`, "Record a validation owner and resolve it before the affected implementation stage.");
+        }
+    }
+    const coveredRequirements = new Set(brief.acceptanceCriteria.flatMap((entry) => entry.requirementRefs));
+    const coveredTasks = new Set(brief.acceptanceCriteria.flatMap((entry) => entry.taskRefs));
+    for (const [index, requirement] of brief.requirements.entries()) {
+        if (requirement.priority === "must" && !coveredRequirements.has(requirement.id)) {
+            addFinding(findings, "ZTDE-BRIEF-701", "error", `requirements[${index}]`, `Must-have requirement ${requirement.id} has no acceptance criterion.`, "Add an observable criterion, verification method, and expected evidence.");
+        }
+    }
+    for (const [index, task] of brief.tasks.entries()) {
+        if (!coveredTasks.has(task.id)) {
+            addFinding(findings, "ZTDE-BRIEF-702", "error", `tasks[${index}]`, `Task ${task.id} has no acceptance coverage.`, "Add at least one criterion proving its success or recovery signal.");
+        }
+    }
+    if (!brief.requirements.some((entry) => entry.category === "accessibility" && entry.priority === "must")) {
+        addFinding(findings, "ZTDE-BRIEF-703", "error", "requirements", "The brief has no must-have accessibility requirement.", "Declare measurable keyboard, focus, contrast, reflow, target, and assistive-technology obligations as applicable.");
+    }
+    if (brief.dataSources.some((entry) => ["confidential", "restricted"].includes(entry.classification)) &&
+        !brief.requirements.some((entry) => ["privacy", "security"].includes(entry.category) && entry.priority === "must")) {
+        addFinding(findings, "ZTDE-BRIEF-704", "error", "requirements", "Sensitive data is declared without a must-have privacy or security requirement.", "Declare handling, authorization, retention, disclosure, and verification requirements for sensitive data.");
+    }
+    const downstreamKinds = brief.downstreamContracts.map((entry) => entry.kind);
+    for (const kind of DOWNSTREAM_KINDS) {
+        if (!downstreamKinds.includes(kind)) {
+            addFinding(findings, "ZTDE-BRIEF-801", "error", "downstreamContracts", `Downstream decision ${kind} is missing.`, "Declare it planned, existing with a path, or not applicable with a reason.");
+        }
+    }
+    for (const duplicate of duplicates(downstreamKinds)) {
+        addFinding(findings, "ZTDE-BRIEF-001", "error", "downstreamContracts", `Duplicate downstream contract kind: ${duplicate}.`, "Declare each downstream contract decision once.");
+    }
+    const inspectForPlaceholders = [
+        ["problem.statement", brief.problem.statement],
+        ["problem.currentOutcome", brief.problem.currentOutcome],
+        ["problem.desiredOutcome", brief.problem.desiredOutcome],
+        ...brief.audiences.map((entry, index) => [`audiences[${index}].role`, entry.role]),
+        ...brief.tasks.flatMap((entry, index) => [
+            [`tasks[${index}].goal`, entry.goal],
+            [`tasks[${index}].successSignal`, entry.successSignal],
+            [`tasks[${index}].recovery`, entry.recovery],
+        ]),
+        ...brief.requirements.map((entry, index) => [`requirements[${index}].statement`, entry.statement]),
+        ...brief.acceptanceCriteria.map((entry, index) => [`acceptanceCriteria[${index}].statement`, entry.statement]),
+    ];
+    for (const [path, value] of inspectForPlaceholders) {
+        if (PLACEHOLDER_PATTERN.test(value)) {
+            addFinding(findings, "ZTDE-BRIEF-901", "error", path, `Generation-critical text contains unresolved placeholder language: ${JSON.stringify(value)}.`, "Replace placeholder language with evidence-backed content or record a bounded assumption explicitly.");
+        }
+    }
+    if (brief.status === "draft") {
+        addFinding(findings, "ZTDE-BRIEF-902", "info", "status", "The brief is still draft and cannot authorize generation.", "Review the report, resolve blockers, and set status to validated only when the evidence is current.");
+    }
+    const summary = findings.reduce((counts, finding) => ({ ...counts, [finding.severity]: counts[finding.severity] + 1 }), { error: 0, warning: 0, info: 0 });
+    const passed = summary.error === 0;
+    return {
+        version: REPORT_VERSION,
+        generatedAt: new Date().toISOString(),
+        sourcePath: basename(sourcePath),
+        briefId: brief.id,
+        product: brief.product,
+        findings,
+        coverage: {
+            evidenceSources: brief.evidenceSources.length,
+            audiences: brief.audiences.length,
+            primaryAudiences: primaryAudiences.length,
+            outcomes: brief.outcomes.length,
+            tasks: brief.tasks.length,
+            dataSources: brief.dataSources.length,
+            states: brief.states.length,
+            platforms: brief.platforms.length,
+            requirements: brief.requirements.length,
+            acceptanceCriteria: brief.acceptanceCriteria.length,
+        },
+        summary: { errors: summary.error, warnings: summary.warning, info: summary.info },
+        passed,
+        generationReady: passed && brief.status === "validated",
+        limitations: [
+            "This validator checks declared evidence, references, task and state completeness, acceptance coverage, and generation-readiness boundaries; it does not prove that the product problem or proposed solution is correct.",
+            "A validated brief authorizes design planning, not implementation release. Downstream architecture, trust, information, design, browser, and quality-gate evidence remain required.",
+            "Human or representative-user verification methods are evidence requirements only. This tool does not create or satisfy human attestations.",
+        ],
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/src/product-brief/validator.js.map

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

package/dist/src/product.d.ts

@@ -0,0 +1,7 @@
+export declare const PRODUCT_NAME = "ZtotheZ Design Engineering System";
+export declare const PRODUCT_SHORT_NAME = "ZtotheZ Design Engineering";
+export declare const PRODUCT_ID = "ztothez-design-engineering";
+export declare const PACKAGE_NAME = "@ztothez/design-engineering";
+export declare const CLI_COMMANDS: readonly ["ztothez-design", "zz-design"];
+export declare const VERSION = "2.0.0";
+export declare function formatCliHelp(command?: string): string;

package/dist/src/product.js

@@ -0,0 +1,28 @@
+export const PRODUCT_NAME = "ZtotheZ Design Engineering System";
+export const PRODUCT_SHORT_NAME = "ZtotheZ Design Engineering";
+export const PRODUCT_ID = "ztothez-design-engineering";
+export const PACKAGE_NAME = "@ztothez/design-engineering";
+export const CLI_COMMANDS = ["ztothez-design", "zz-design"];
+export const VERSION = "2.0.0";
+export function formatCliHelp(command = CLI_COMMANDS[0]) {
+    return [
+        PRODUCT_NAME,
+        "",
+        `Usage: ${command} [--help | --version]`,
+        `       ${command} validate-brief --brief PATH [--json]`,
+        `       ${command} compile-plan --brief PATH [--project-root PATH] [--json]`,
+        `       ${command} generate-react --plan PATH --generation-root PATH --output PATH --portfolio-registry PATH [--json]`,
+        `       ${command} repair-react --request PATH --generation-root PATH --target PATH --portfolio-registry PATH --contract PATH --url URL --profile ID --output PATH [--json]`,
+        `       ${command} portfolio validate-registry|inventory|capabilities|run-stage|snapshot|baseline|benchmark|verify-unchanged|report [options]`,
+        "",
+        `Without arguments, starts the ${PRODUCT_ID} MCP server over stdio.`,
+        `Both ${CLI_COMMANDS[0]} and ${CLI_COMMANDS[1]} invoke this executable.`,
+        `Use ${command} validate-brief --help for product intake validation.`,
+        `Use ${command} compile-plan --help for deterministic design planning.`,
+        `Use ${command} generate-react --help for contained React and TypeScript fixture generation.`,
+        `Use ${command} repair-react --help for finding-bound closed-loop remediation.`,
+        `Use ${command} portfolio --help for local read-only benchmark commands.`,
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=product.js.map

package/dist/src/product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.js","sourceRoot":"","sources":["../../src/product.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,mCAAmC,CAAC;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAC/D,MAAM,CAAC,MAAM,UAAU,GAAG,4BAA4B,CAAC;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG,6BAA6B,CAAC;AAC1D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,gBAAgB,EAAE,WAAW,CAAU,CAAC;AACrE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,MAAM,UAAU,aAAa,CAAC,UAAkB,YAAY,CAAC,CAAC,CAAC;IAC7D,OAAO;QACL,YAAY;QACZ,EAAE;QACF,UAAU,OAAO,uBAAuB;QACxC,UAAU,OAAO,uCAAuC;QACxD,UAAU,OAAO,2DAA2D;QAC5E,UAAU,OAAO,qGAAqG;QACtH,UAAU,OAAO,2JAA2J;QAC5K,UAAU,OAAO,6HAA6H;QAC9I,EAAE;QACF,iCAAiC,UAAU,yBAAyB;QACpE,QAAQ,YAAY,CAAC,CAAC,CAAC,QAAQ,YAAY,CAAC,CAAC,CAAC,0BAA0B;QACxE,OAAO,OAAO,uDAAuD;QACrE,OAAO,OAAO,yDAAyD;QACvE,OAAO,OAAO,+EAA+E;QAC7F,OAAO,OAAO,iEAAiE;QAC/E,OAAO,OAAO,2DAA2D;QACzE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/quality-gate/report.d.ts

@@ -0,0 +1,2 @@
+import type { QualityGateReport } from "./types.js";
+export declare function formatQualityGateReport(report: QualityGateReport): string;