@ztothez/design-engineering 2.0.0

package/dist/src/retrieval/schema.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+export const retrievalCategories = [
+    "skill",
+    "architecture",
+    "design-intelligence",
+    "ux-patterns",
+    "usability-evaluation",
+];
+export const retrievalCategorySchema = z.enum(retrievalCategories);
+const scopeCategorySchema = z
+    .object({
+    label: z.string().trim().min(1).max(160),
+    files: z.array(z.string().trim().min(1).max(1_024)).min(1).max(200),
+})
+    .strict();
+export const retrievalScopeSchema = z
+    .object({
+    version: z.literal("1.0"),
+    authority: z.literal("SKILL.md"),
+    categories: z
+        .object({
+        skill: scopeCategorySchema,
+        architecture: scopeCategorySchema,
+        "design-intelligence": scopeCategorySchema,
+        "ux-patterns": scopeCategorySchema,
+        "usability-evaluation": scopeCategorySchema,
+    })
+        .strict(),
+})
+    .strict();
+export const knowledgeSearchInputSchema = z
+    .object({
+    query: z.string().trim().min(2).max(256),
+    categories: z
+        .array(retrievalCategorySchema)
+        .min(1)
+        .max(6)
+        .refine((categories) => new Set(categories).size === categories.length, {
+        message: "Retrieval categories must be unique",
+    })
+        .optional(),
+    limit: z.number().int().min(1).max(10).optional(),
+})
+    .strict();
+export const knowledgeSearchResultSchema = z
+    .object({
+    rank: z.number().int().positive(),
+    path: z.string(),
+    category: retrievalCategorySchema,
+    authority: z.enum(["authoritative", "approved"]),
+    title: z.string(),
+    section: z.string(),
+    excerpt: z.string(),
+    score: z.number().nonnegative(),
+    confidence: z.enum(["high", "medium", "low"]),
+    matchedTerms: z.array(z.string()),
+})
+    .strict();
+export const knowledgeSearchReportSchema = z
+    .object({
+    version: z.literal("1.0"),
+    query: z.string(),
+    categories: z.array(retrievalCategorySchema),
+    authorityPath: z.literal("SKILL.md"),
+    status: z.enum(["matches", "no-match"]),
+    message: z.string(),
+    results: z.array(knowledgeSearchResultSchema),
+    stats: z
+        .object({
+        documentsSearched: z.number().int().nonnegative(),
+        chunksSearched: z.number().int().nonnegative(),
+        searchableTerms: z.array(z.string()),
+    })
+        .strict(),
+})
+    .strict();
+//# sourceMappingURL=schema.js.map

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

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

package/dist/src/retrieval/search.d.ts

@@ -0,0 +1,26 @@
+import { type KnowledgeSearchInput, type KnowledgeSearchReport, type RetrievalCategory } from "./schema.js";
+type IndexedChunk = {
+    id: number;
+    path: string;
+    category: RetrievalCategory;
+    authority: "authoritative" | "approved";
+    title: string;
+    section: string;
+    text: string;
+    normalizedText: string;
+    termFrequency: Map<string, number>;
+    length: number;
+};
+export type KnowledgeIndex = {
+    version: "1.0";
+    authorityPath: "SKILL.md";
+    documents: Array<{
+        path: string;
+        category: RetrievalCategory;
+    }>;
+    chunks: IndexedChunk[];
+};
+export declare function tokenizeForRetrieval(value: string): string[];
+export declare function buildKnowledgeIndex(projectRoot: string, scopePath?: string): Promise<KnowledgeIndex>;
+export declare function searchKnowledge(index: KnowledgeIndex, input: KnowledgeSearchInput): KnowledgeSearchReport;
+export {};

package/dist/src/retrieval/search.js

@@ -0,0 +1,415 @@
+import { readFile, realpath, stat } from "node:fs/promises";
+import { basename, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { parse } from "yaml";
+import { knowledgeSearchInputSchema, retrievalCategories, retrievalScopeSchema, } from "./schema.js";
+const MAX_SOURCE_BYTES = 2 * 1024 * 1024;
+const MAX_CHUNK_CHARACTERS = 1_600;
+const MAX_EXCERPT_CHARACTERS = 560;
+const BM25_K1 = 1.2;
+const BM25_B = 0.75;
+const stopWords = new Set([
+    "a",
+    "an",
+    "and",
+    "are",
+    "as",
+    "at",
+    "be",
+    "by",
+    "for",
+    "from",
+    "has",
+    "in",
+    "is",
+    "it",
+    "of",
+    "on",
+    "or",
+    "that",
+    "the",
+    "this",
+    "to",
+    "was",
+    "when",
+    "with",
+]);
+const categoryRoots = {
+    skill: "SKILL.md",
+    architecture: "knowledge-base/maintained/architecture",
+    "design-intelligence": "knowledge-base/design-intelligence",
+    "ux-patterns": "knowledge-base/maintained/product-patterns",
+    "usability-evaluation": "knowledge-base/usability-evaluation",
+};
+function isPathContained(baseDirectory, candidatePath) {
+    const relation = relative(baseDirectory, candidatePath);
+    return (relation === "" ||
+        (!relation.startsWith(`..${sep}`) && relation !== ".." && !isAbsolute(relation)));
+}
+function normalizeText(value) {
+    return value
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, " ")
+        .trim();
+}
+function stem(token) {
+    if (token.length > 5 && token.endsWith("ies"))
+        return `${token.slice(0, -3)}y`;
+    if (token.length > 6 && token.endsWith("ing"))
+        return token.slice(0, -3);
+    if (token.length > 5 && token.endsWith("ed"))
+        return token.slice(0, -2);
+    if (token.length > 5 && token.endsWith("sses"))
+        return token.slice(0, -2);
+    if (token.length > 5 && /(?:ches|shes|xes|zes|oes)$/.test(token)) {
+        return token.slice(0, -2);
+    }
+    if (token.length > 4 &&
+        token.endsWith("s") &&
+        !token.endsWith("ss") &&
+        !token.endsWith("us")) {
+        return token.slice(0, -1);
+    }
+    return token;
+}
+export function tokenizeForRetrieval(value) {
+    const lexicalTokens = value
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .match(/[\p{L}\p{N}]+(?:[-_][\p{L}\p{N}]+)*/gu) ?? [];
+    const expanded = lexicalTokens.flatMap((token) => {
+        const parts = token.split(/[-_]/).filter(Boolean);
+        return parts.length > 1 ? [...parts, parts.join("")] : parts;
+    });
+    return expanded
+        .filter((token) => token.length > 1 && !stopWords.has(token))
+        .map(stem);
+}
+function addWeightedTerms(target, terms, weight) {
+    for (const term of terms)
+        target.set(term, (target.get(term) ?? 0) + weight);
+}
+function cleanMarkdownText(value) {
+    return value
+        .replace(/\uE200cite\uE202[^\uE201]*\uE201/gu, " ")
+        .replace(/^```[^\n]*$/gm, " ")
+        .replace(/[`*_>#|]/g, " ")
+        .replace(/\[([^\]]+)]\([^)]*\)/g, "$1")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function splitLongParagraph(paragraph) {
+    if (paragraph.length <= MAX_CHUNK_CHARACTERS)
+        return [paragraph];
+    const words = paragraph.split(/\s+/);
+    const segments = [];
+    let current = "";
+    for (const word of words) {
+        if (current && current.length + word.length + 1 > MAX_CHUNK_CHARACTERS) {
+            segments.push(current);
+            current = word;
+        }
+        else {
+            current = current ? `${current} ${word}` : word;
+        }
+    }
+    if (current)
+        segments.push(current);
+    return segments;
+}
+function splitSectionBody(body) {
+    const paragraphs = body
+        .split(/\n\s*\n/)
+        .map(cleanMarkdownText)
+        .filter(Boolean)
+        .flatMap(splitLongParagraph);
+    const chunks = [];
+    let current = "";
+    for (const paragraph of paragraphs) {
+        if (current && current.length + paragraph.length + 2 > MAX_CHUNK_CHARACTERS) {
+            chunks.push(current);
+            current = paragraph;
+        }
+        else {
+            current = current ? `${current}\n\n${paragraph}` : paragraph;
+        }
+    }
+    if (current)
+        chunks.push(current);
+    return chunks;
+}
+function markdownSections(content, fallbackTitle) {
+    const withoutFrontmatter = content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, "");
+    const lines = withoutFrontmatter.split(/\r?\n/);
+    const titleLine = lines.find((line) => /^#\s+/.test(line));
+    const title = cleanMarkdownText(titleLine?.replace(/^#\s+/, "") ?? fallbackTitle);
+    const headingStack = [];
+    const sections = [];
+    let bodyLines = [];
+    const flush = () => {
+        const body = bodyLines.join("\n");
+        const section = headingStack.length > 0 ? headingStack.join(" > ") : title;
+        for (const text of splitSectionBody(body))
+            sections.push({ title, section, text });
+        bodyLines = [];
+    };
+    for (const line of lines) {
+        const match = /^(#{1,6})\s+(.+?)\s*$/.exec(line);
+        if (!match) {
+            bodyLines.push(line);
+            continue;
+        }
+        flush();
+        const level = match[1]?.length ?? 1;
+        const heading = cleanMarkdownText(match[2] ?? "");
+        headingStack.splice(level - 1);
+        headingStack[level - 1] = heading;
+    }
+    flush();
+    return sections;
+}
+function validateScopedPath(category, path) {
+    if (path.includes("\0") || isAbsolute(path) || !path.toLowerCase().endsWith(".md")) {
+        throw new Error(`Invalid retrieval scope path: ${path}`);
+    }
+    const normalized = path.split("\\").join("/").replace(/^\.\//, "");
+    const requiredRoot = categoryRoots[category];
+    const valid = category === "skill"
+        ? normalized === requiredRoot
+        : normalized.startsWith(`${requiredRoot}/`) && !normalized.includes("/../");
+    if (!valid) {
+        throw new Error(`Retrieval path is outside the ${category} category: ${path}`);
+    }
+}
+async function loadScope(projectRoot, scopePath) {
+    const root = await realpath(projectRoot);
+    const resolvedScope = await realpath(resolve(scopePath));
+    if (!isPathContained(root, resolvedScope)) {
+        throw new Error("Retrieval scope resolves outside the project root");
+    }
+    const parsed = parse(await readFile(resolvedScope, "utf8"));
+    const scope = retrievalScopeSchema.parse(parsed);
+    const seen = new Set();
+    for (const category of retrievalCategories) {
+        for (const path of scope.categories[category].files) {
+            validateScopedPath(category, path);
+            if (seen.has(path))
+                throw new Error(`Duplicate retrieval scope path: ${path}`);
+            seen.add(path);
+        }
+    }
+    if (!scope.categories.skill.files.includes(scope.authority)) {
+        throw new Error("The authoritative skill must be included in the skill category");
+    }
+    return scope;
+}
+export async function buildKnowledgeIndex(projectRoot, scopePath = join(projectRoot, "knowledge-base", "retrieval-scope.yaml")) {
+    const root = await realpath(projectRoot);
+    const scope = await loadScope(root, scopePath);
+    const documents = [];
+    const chunks = [];
+    for (const category of retrievalCategories) {
+        for (const sourcePath of scope.categories[category].files) {
+            const candidate = resolve(root, sourcePath);
+            if (!isPathContained(root, candidate)) {
+                throw new Error(`Retrieval source escapes the project root: ${sourcePath}`);
+            }
+            const resolvedSource = await realpath(candidate);
+            if (!isPathContained(root, resolvedSource)) {
+                throw new Error(`Retrieval source resolves outside the project root: ${sourcePath}`);
+            }
+            const sourceStats = await stat(resolvedSource);
+            if (!sourceStats.isFile() || sourceStats.size > MAX_SOURCE_BYTES) {
+                throw new Error(`Retrieval source is unavailable or exceeds the size limit: ${sourcePath}`);
+            }
+            const content = await readFile(resolvedSource, "utf8");
+            documents.push({ path: sourcePath, category });
+            const fallbackTitle = basename(sourcePath, ".md").replace(/[_-]+/g, " ");
+            for (const section of markdownSections(content, fallbackTitle)) {
+                const bodyTerms = tokenizeForRetrieval(section.text);
+                if (bodyTerms.length === 0)
+                    continue;
+                const termFrequency = new Map();
+                addWeightedTerms(termFrequency, bodyTerms, 1);
+                addWeightedTerms(termFrequency, tokenizeForRetrieval(section.section), 2);
+                addWeightedTerms(termFrequency, tokenizeForRetrieval(section.title), 1.5);
+                addWeightedTerms(termFrequency, tokenizeForRetrieval(sourcePath), 0.5);
+                chunks.push({
+                    id: chunks.length,
+                    path: sourcePath,
+                    category,
+                    authority: sourcePath === scope.authority ? "authoritative" : "approved",
+                    title: section.title,
+                    section: section.section,
+                    text: section.text,
+                    normalizedText: normalizeText(`${section.title} ${section.section} ${section.text}`),
+                    termFrequency,
+                    length: bodyTerms.length,
+                });
+            }
+        }
+    }
+    return {
+        version: scope.version,
+        authorityPath: scope.authority,
+        documents,
+        chunks,
+    };
+}
+function makeExcerpt(text, query) {
+    const clean = cleanMarkdownText(text);
+    if (clean.length <= MAX_EXCERPT_CHARACTERS)
+        return clean;
+    const queryWords = normalizeText(query).split(" ").filter((word) => word.length > 1);
+    const lower = clean.toLowerCase();
+    const positions = queryWords
+        .map((word) => lower.indexOf(word))
+        .filter((position) => position >= 0);
+    const matchPosition = positions.length > 0 ? Math.min(...positions) : 0;
+    let start = Math.max(0, matchPosition - Math.floor(MAX_EXCERPT_CHARACTERS / 3));
+    let end = Math.min(clean.length, start + MAX_EXCERPT_CHARACTERS);
+    if (end === clean.length)
+        start = Math.max(0, end - MAX_EXCERPT_CHARACTERS);
+    if (start > 0) {
+        const nextSpace = clean.indexOf(" ", start);
+        if (nextSpace >= 0 && nextSpace < end)
+            start = nextSpace + 1;
+    }
+    if (end < clean.length) {
+        const previousSpace = clean.lastIndexOf(" ", end);
+        if (previousSpace > start)
+            end = previousSpace;
+    }
+    return `${start > 0 ? "..." : ""}${clean.slice(start, end).trim()}${end < clean.length ? "..." : ""}`;
+}
+function confidenceFor(queryTermCount, matchedTermCount, exactPhrase) {
+    const coverage = matchedTermCount / queryTermCount;
+    if (exactPhrase || (queryTermCount >= 2 && coverage === 1))
+        return "high";
+    if (coverage >= 0.5 || queryTermCount === 1)
+        return "medium";
+    return "low";
+}
+export function searchKnowledge(index, input) {
+    const options = knowledgeSearchInputSchema.parse(input);
+    const categories = options.categories ?? [...retrievalCategories];
+    const selectedCategories = new Set(categories);
+    const selectedChunks = index.chunks.filter((chunk) => selectedCategories.has(chunk.category));
+    const selectedDocuments = index.documents.filter((document) => selectedCategories.has(document.category));
+    const queryTerms = [...new Set(tokenizeForRetrieval(options.query))];
+    const stats = {
+        documentsSearched: selectedDocuments.length,
+        chunksSearched: selectedChunks.length,
+        searchableTerms: queryTerms,
+    };
+    if (queryTerms.length === 0) {
+        return {
+            version: "1.0",
+            query: options.query,
+            categories,
+            authorityPath: index.authorityPath,
+            status: "no-match",
+            message: "The query contains no searchable terms after normalization.",
+            results: [],
+            stats,
+        };
+    }
+    const documentFrequency = new Map();
+    for (const term of queryTerms) {
+        documentFrequency.set(term, selectedChunks.reduce((count, chunk) => count + (chunk.termFrequency.has(term) ? 1 : 0), 0));
+    }
+    const averageLength = selectedChunks.length > 0
+        ? selectedChunks.reduce((total, chunk) => total + chunk.length, 0) /
+            selectedChunks.length
+        : 1;
+    const normalizedPhrase = normalizeText(options.query);
+    const scored = selectedChunks
+        .map((chunk) => {
+        const matchedTerms = queryTerms.filter((term) => chunk.termFrequency.has(term));
+        if (matchedTerms.length === 0)
+            return undefined;
+        let score = 0;
+        for (const term of matchedTerms) {
+            const frequency = chunk.termFrequency.get(term) ?? 0;
+            const containingChunks = documentFrequency.get(term) ?? 0;
+            const inverseDocumentFrequency = Math.log(1 + (selectedChunks.length - containingChunks + 0.5) / (containingChunks + 0.5));
+            const lengthNormalization = frequency +
+                BM25_K1 * (1 - BM25_B + BM25_B * (chunk.length / Math.max(averageLength, 1)));
+            score += inverseDocumentFrequency * ((frequency * (BM25_K1 + 1)) / lengthNormalization);
+        }
+        const exactPhrase = normalizedPhrase.length > 2 && chunk.normalizedText.includes(normalizedPhrase);
+        if (exactPhrase)
+            score *= 1.35;
+        const titleTerms = new Set(tokenizeForRetrieval(chunk.title));
+        const titleMatches = matchedTerms.filter((term) => titleTerms.has(term)).length;
+        if (titleMatches > 0)
+            score *= 1 + 0.4 * Math.min(titleMatches / 2, 1);
+        if (chunk.authority === "authoritative")
+            score *= 1.12;
+        return {
+            chunk,
+            matchedTerms,
+            exactPhrase,
+            score,
+        };
+    })
+        .filter((candidate) => candidate !== undefined)
+        .sort((left, right) => right.score - left.score ||
+        Number(right.chunk.authority === "authoritative") -
+            Number(left.chunk.authority === "authoritative") ||
+        left.chunk.path.localeCompare(right.chunk.path) ||
+        left.chunk.section.localeCompare(right.chunk.section) ||
+        left.chunk.id - right.chunk.id);
+    const limit = options.limit ?? 5;
+    const minimumMatchedTerms = queryTerms.length >= 4
+        ? Math.max(2, Math.ceil(queryTerms.length * 0.2))
+        : 1;
+    const sourceCounts = new Map();
+    const selected = scored
+        .filter((candidate) => candidate.exactPhrase || candidate.matchedTerms.length >= minimumMatchedTerms)
+        .filter((candidate) => {
+        const count = sourceCounts.get(candidate.chunk.path) ?? 0;
+        if (count >= 2)
+            return false;
+        sourceCounts.set(candidate.chunk.path, count + 1);
+        return true;
+    })
+        .slice(0, limit);
+    if (selected.length === 0) {
+        return {
+            version: "1.0",
+            query: options.query,
+            categories,
+            authorityPath: index.authorityPath,
+            status: "no-match",
+            message: "No approved knowledge source contains the normalized query terms.",
+            results: [],
+            stats,
+        };
+    }
+    const results = selected.map((candidate, resultIndex) => ({
+        rank: resultIndex + 1,
+        path: candidate.chunk.path,
+        category: candidate.chunk.category,
+        authority: candidate.chunk.authority,
+        title: candidate.chunk.title,
+        section: candidate.chunk.section,
+        excerpt: makeExcerpt(candidate.chunk.text, options.query),
+        score: Number(candidate.score.toFixed(6)),
+        confidence: confidenceFor(queryTerms.length, candidate.matchedTerms.length, candidate.exactPhrase),
+        matchedTerms: candidate.matchedTerms,
+    }));
+    return {
+        version: "1.0",
+        query: options.query,
+        categories,
+        authorityPath: index.authorityPath,
+        status: "matches",
+        message: `Found ${results.length} ranked result${results.length === 1 ? "" : "s"} in the approved retrieval scope.`,
+        results,
+        stats,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/src/retrieval/search.js.map

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

package/dist/src/runtime/advanced-checks.d.ts

@@ -0,0 +1,6 @@
+import type { Page } from "playwright-core";
+import type { RuntimeFinding, RuntimeViewport } from "./types.js";
+export declare function checkTextContrast(page: Page, viewport: RuntimeViewport, findings: RuntimeFinding[]): Promise<void>;
+export declare function checkTouchTargets(page: Page, viewport: RuntimeViewport, findings: RuntimeFinding[]): Promise<void>;
+export declare function checkReflowAndTextResize(page: Page, viewport: RuntimeViewport, findings: RuntimeFinding[]): Promise<void>;
+export declare function checkReducedMotion(page: Page, viewport: RuntimeViewport, findings: RuntimeFinding[]): Promise<void>;