tevra-design-kit 0.0.0-stage → 1.0.0

package/dist/packages/design-context/src/migrate.js.map

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

package/dist/packages/design-context/src/tokens.d.ts

@@ -0,0 +1,8 @@
+import type { DesignContext } from '../../contracts/src/index.js';
+export declare function contrastRatio(first: string, second: string): number;
+export declare function createFoundation(brand?: string): DesignContext['tokens'];
+export declare function exportTokens(tokens: DesignContext['tokens']): {
+    css: string;
+    tailwind: string;
+    portable: string;
+};

package/dist/packages/design-context/src/tokens.js

@@ -0,0 +1,65 @@
+export function contrastRatio(first, second) {
+    function luminance(hex) {
+        if (!/^#[\da-f]{6}$/iu.test(hex))
+            throw new Error('Contrast input must be a six-digit hex color');
+        const channels = [1, 3, 5].map(offset => { const channel = Number.parseInt(hex.slice(offset, offset + 2), 16) / 255; return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4; });
+        return (channels[0] ?? 0) * 0.2126 + (channels[1] ?? 0) * 0.7152 + (channels[2] ?? 0) * 0.0722;
+    }
+    const left = luminance(first);
+    const right = luminance(second);
+    return (Math.max(left, right) + 0.05) / (Math.min(left, right) + 0.05);
+}
+export function createFoundation(brand = '#175a44') {
+    if (!/^#[\da-f]{6}$/iu.test(brand))
+        throw new Error('Brand color must be a six-digit hex color');
+    return {
+        primitive: { 'color.brand': brand, 'color.ink': '#17231e', 'color.paper': '#fbfcf9', 'color.white': '#ffffff', 'space.1': '0.25rem', 'space.2': '0.5rem', 'space.3': '0.75rem', 'space.4': '1rem', 'space.6': '1.5rem', 'space.8': '2rem', 'radius.control': '0.5rem', 'type.body': '1rem', 'type.title': 'clamp(1.75rem, 3vw, 2.75rem)', 'motion.feedback': '160ms', 'motion.enter': '240ms', 'motion.ease': 'cubic-bezier(0.2, 0, 0, 1)', 'shadow.panel': '0 2px 12px rgb(0 0 0 / 0.08)' },
+        semantic: { 'color.accent': '{primitive.color.brand}', 'color.on-accent': contrastRatio(brand, '#ffffff') >= 4.5 ? '#ffffff' : '#000000', 'color.text': '{primitive.color.ink}', 'color.canvas': '{primitive.color.paper}', 'color.surface': '{primitive.color.white}', 'color.focus': '#145bb5', 'color.danger': '#b42318', 'type.body': '{primitive.type.body}', 'type.heading': '{primitive.type.title}' },
+        component: { 'button.radius': '{primitive.radius.control}', 'button.padding': '{primitive.space.3}', 'button.primary.background': '{semantic.color.accent}', 'button.primary.text': '{semantic.color.on-accent}', 'button.disabled.opacity': '0.6', 'panel.shadow': '{primitive.shadow.panel}' },
+        themes: { light: { 'color.text': '#17231e', 'color.canvas': '#fbfcf9', 'color.surface': '#ffffff', 'color.accent': brand, 'color.on-accent': contrastRatio(brand, '#ffffff') >= 4.5 ? '#ffffff' : '#000000' }, dark: { 'color.text': '#e8f0eb', 'color.canvas': '#111a16', 'color.surface': '#1b2922', 'color.accent': '#88d4af', 'color.on-accent': '#111a16', 'color.focus': '#9fc6ff', 'color.danger': '#ffb4ab' } },
+        responsive: { 'breakpoint.tablet': '48rem', 'breakpoint.desktop': '80rem', 'content.max': '76rem', 'type.title': 'clamp(1.75rem, 3vw, 2.75rem)' }
+    };
+}
+export function exportTokens(tokens) {
+    const flat = {};
+    for (const layer of ['primitive', 'semantic', 'component', 'responsive'])
+        for (const [key, value] of Object.entries(tokens[layer]))
+            flat[`${layer}.${key}`] = value;
+    const cssName = (name) => `--tevra-${name.replace(/\./gu, '-')}`;
+    if (new Set(Object.keys(flat).map(cssName)).size !== Object.keys(flat).length)
+        throw new Error('Token names collide after CSS variable normalization');
+    const active = new Set();
+    function value(name) {
+        if (active.has(name))
+            throw new Error(`Cyclic token reference: ${name}`);
+        const raw = flat[name];
+        if (raw === undefined)
+            throw new Error(`Missing token reference: ${name}`);
+        const reference = /^\{([a-zA-Z0-9_.-]+)\}$/u.exec(raw);
+        if (reference?.[1]) {
+            active.add(name);
+            value(reference[1]);
+            active.delete(name);
+            return `var(${cssName(reference[1])})`;
+        }
+        if (/[;{}<>@]/u.test(raw))
+            throw new Error(`Unsafe CSS token value: ${name}`);
+        return raw;
+    }
+    const declarations = Object.keys(flat).map(name => `  ${cssName(name)}: ${value(name)};`).join('\n');
+    let css = `:root {\n${declarations}\n}\n`;
+    for (const [theme, entries] of Object.entries(tokens.themes)) {
+        if (!/^[a-z][a-z0-9-]*$/u.test(theme))
+            throw new Error(`Unsafe theme name: ${theme}`);
+        const declarations = Object.entries(entries).map(([name, raw]) => {
+            flat[`theme.${name}`] = raw;
+            return `  ${cssName(`semantic.${name}`)}: ${value(`theme.${name}`)};`;
+        }).join('\n');
+        css += `[data-theme="${theme}"] {\n${declarations}\n}\n`;
+        if (theme === 'dark')
+            css += `@media (prefers-color-scheme: dark) {\n  :root:not([data-theme="light"]) {\n${declarations}\n  }\n}\n`;
+    }
+    const theme = Object.keys(tokens.semantic).filter(name => /^(color|type)\./u.test(name)).map(name => `  --${name.replace(/^type\./u, 'text.').replace(/\./gu, '-')}: var(${cssName(`semantic.${name}`)});`).join('\n');
+    return { css, tailwind: `@import "tailwindcss";\n@import "./tokens.css";\n@theme inline {\n${theme}\n}\n`, portable: `${JSON.stringify({ version: 1, layers: tokens }, null, 2)}\n` };
+}
+//# sourceMappingURL=tokens.js.map

package/dist/packages/design-context/src/tokens.js.map

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

package/dist/packages/design-context/src/validation.d.ts

@@ -0,0 +1 @@
+export declare function validate<T>(schema: string, value: unknown): T;

package/dist/packages/design-context/src/validation.js

@@ -0,0 +1,22 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import { kitRoot } from '../../filesystem/src/resources.js';
+const ajv = new Ajv2020({ allErrors: true, strict: true });
+ajv.addFormat('uri-reference', { type: 'string', validate: (value) => !/\s/u.test(value) });
+ajv.addFormat('date-time', { type: 'string', validate: (value) => /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/u.test(value) && Number.isFinite(Date.parse(value)) });
+const validators = new Map();
+export function validate(schema, value) {
+    let checker = validators.get(schema);
+    if (!checker) {
+        const definition = JSON.parse(readFileSync(resolve(kitRoot(), 'schemas', schema), 'utf8'));
+        if (!definition || typeof definition !== 'object')
+            throw new Error(`Invalid bundled schema ${schema}`);
+        checker = ajv.compile(definition);
+        validators.set(schema, checker);
+    }
+    if (!checker(value))
+        throw new Error(`${schema}: ${ajv.errorsText(checker.errors, { separator: '; ' })}`);
+    return value;
+}
+//# sourceMappingURL=validation.js.map

package/dist/packages/design-context/src/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../packages/design-context/src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAE5D,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACpG,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,uEAAuE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;AACvM,MAAM,UAAU,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEvD,MAAM,UAAU,QAAQ,CAAI,MAAc,EAAE,KAAc;IACxD,IAAI,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,UAAU,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACpG,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;QACvG,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAClC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1G,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/dist/packages/design-memory/src/index.d.ts

@@ -0,0 +1,16 @@
+export interface MemoryEntry {
+    id: string;
+    kind: 'direction' | 'tokens' | 'convention' | 'rejected' | 'redesign' | 'constraint' | 'regression';
+    text: string;
+    approved: boolean;
+    owner: string;
+    updatedAt: string;
+}
+export interface Memory {
+    version: 1;
+    revision: number;
+    entries: MemoryEntry[];
+}
+export declare function inspectMemory(root: string): Promise<Memory>;
+export declare function updateMemory(root: string, entry: unknown, expectedRevision: number): Promise<Memory>;
+export declare function resetMemory(root: string, confirmed: boolean): Promise<Memory>;

package/dist/packages/design-memory/src/index.js

@@ -0,0 +1,47 @@
+import { isMissing, readJSON, redact, safePath, withLock, writeJSON } from '../../filesystem/src/index.js';
+import { stat } from 'node:fs/promises';
+import { validate } from '../../design-context/src/validation.js';
+import { isDeepStrictEqual } from 'node:util';
+const path = '.tevra/memory.json';
+export async function inspectMemory(root) {
+    try {
+        await stat(await safePath(root, path));
+    }
+    catch (error) {
+        if (isMissing(error))
+            return { version: 1, revision: 0, entries: [] };
+        throw error;
+    }
+    return validate('memory.schema.json', await readJSON(root, path));
+}
+export async function updateMemory(root, entry, expectedRevision) {
+    const serialized = JSON.stringify(entry);
+    if (typeof serialized !== 'string' || redact(serialized) !== serialized)
+        throw new Error('Possible secret in memory; remove sensitive values before persistence');
+    return withLock(root, '.tevra/memory.lock', async () => {
+        const memory = await inspectMemory(root);
+        if (expectedRevision !== memory.revision)
+            throw new Error('Stale memory revision');
+        const candidate = validate('memory.schema.json', { ...memory, entries: [entry] }).entries[0];
+        if (!candidate)
+            throw new Error('Memory entry missing');
+        const previous = memory.entries.find(value => value.id === candidate.id);
+        if (previous?.approved && !isDeepStrictEqual(previous, candidate))
+            throw new Error('Approved memory is immutable; append a new decision');
+        memory.entries = [...memory.entries.filter(value => value.id !== candidate.id), candidate];
+        memory.revision++;
+        await writeJSON(root, path, memory);
+        return memory;
+    });
+}
+export async function resetMemory(root, confirmed) {
+    if (!confirmed)
+        throw new Error('Memory reset requires --yes');
+    return withLock(root, '.tevra/memory.lock', async () => {
+        const current = await inspectMemory(root);
+        const reset = { version: 1, revision: current.revision + 1, entries: [] };
+        await writeJSON(root, path, reset);
+        return reset;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/packages/design-memory/src/index.js.map

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

package/dist/packages/filesystem/src/index.d.ts

@@ -0,0 +1,8 @@
+export declare function projectRoot(path: string): Promise<string>;
+export declare function safePath(root: string, name: string): Promise<string>;
+export declare function isMissing(error: unknown): boolean;
+export declare function readJSON(root: string, name: string): Promise<unknown>;
+export declare function writeAtomic(root: string, name: string, content: string | Uint8Array): Promise<void>;
+export declare function writeJSON(root: string, name: string, value: unknown): Promise<void>;
+export declare function withLock<T>(root: string, name: string, action: () => Promise<T>): Promise<T>;
+export declare function redact(text: string): string;

package/dist/packages/filesystem/src/index.js

@@ -0,0 +1,83 @@
+import { lstat, mkdir, open, readFile, realpath, rename, unlink } from 'node:fs/promises';
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { randomUUID } from 'node:crypto';
+export async function projectRoot(path) { return realpath(resolve(path)); }
+export async function safePath(root, name) {
+    if (!name || isAbsolute(name) || name.split(/[\\/]/u).includes('..') || name.includes('\0'))
+        throw new Error(`Unsafe project path: ${name}`);
+    const destination = resolve(root, name);
+    const local = relative(root, destination);
+    if (!local || local.startsWith(`..${sep}`) || isAbsolute(local))
+        throw new Error(`Path escapes project: ${name}`);
+    let current = root;
+    for (const segment of local.split(sep)) {
+        current = resolve(current, segment);
+        try {
+            if ((await lstat(current)).isSymbolicLink())
+                throw new Error(`Symlink path refused: ${name}`);
+        }
+        catch (error) {
+            if (!isMissing(error))
+                throw error;
+        }
+    }
+    return destination;
+}
+export function isMissing(error) { return error instanceof Error && 'code' in error && error.code === 'ENOENT'; }
+export async function readJSON(root, name) {
+    const path = await safePath(root, name);
+    try {
+        return JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`Cannot read JSON ${name}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+}
+export async function writeAtomic(root, name, content) {
+    const destination = await safePath(root, name);
+    await mkdir(dirname(destination), { recursive: true });
+    await safePath(root, name);
+    const tempName = `${name}.${randomUUID()}.tmp`;
+    const temporary = await safePath(root, tempName);
+    try {
+        await open(temporary, 'wx', 0o600).then(async (file) => { try {
+            await file.writeFile(content);
+            await file.sync();
+        }
+        finally {
+            await file.close();
+        } });
+        await rename(temporary, destination);
+    }
+    finally {
+        try {
+            await unlink(temporary);
+        }
+        catch (error) {
+            if (!isMissing(error))
+                throw error;
+        }
+    }
+}
+export async function writeJSON(root, name, value) { await writeAtomic(root, name, `${JSON.stringify(value, null, 2)}\n`); }
+export async function withLock(root, name, action) {
+    const path = await safePath(root, name);
+    await mkdir(dirname(path), { recursive: true });
+    const lock = await open(path, 'wx', 0o600).catch(error => { throw new Error(`Write lock unavailable (${name}); check concurrent work or inspect a stale lock`, { cause: error }); });
+    try {
+        await lock.writeFile(JSON.stringify({ pid: process.pid, createdAt: new Date().toISOString() }));
+        return await action();
+    }
+    finally {
+        await lock.close();
+        await unlink(path);
+    }
+}
+export function redact(text) {
+    return text.replace(/(https?:\/\/)[^\s/@]+:[^\s/@]+@/gu, '$1[REDACTED]@')
+        .replace(/([?&][^=\s]+)=([^&\s#]*)/gu, '$1=[REDACTED]')
+        .replace(/\b(?:sk-[a-zA-Z0-9_-]{10,}|gh[pousr]_[a-zA-Z0-9_]{10,})\b/gu, '[REDACTED]')
+        .replace(/\b(?:AKIA[0-9A-Z]{16}|eyJ[a-zA-Z0-9_-]+\.[a-zA-Z0-9_-]+\.[a-zA-Z0-9_-]+)\b/gu, '[REDACTED]')
+        .replace(/((?:authorization|password|api[_-]?key|access[_-]?token|secret|cookie|session[_-]?id)\s*[=:]\s*)(?:Bearer\s+)?[^\s,;]+/giu, '$1[REDACTED]');
+}
+//# sourceMappingURL=index.js.map

package/dist/packages/filesystem/src/index.js.map

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

package/dist/packages/filesystem/src/resources.d.ts

@@ -0,0 +1 @@
+export declare function kitRoot(): string;

package/dist/packages/filesystem/src/resources.js

@@ -0,0 +1,13 @@
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export function kitRoot() {
+    let current = dirname(fileURLToPath(import.meta.url));
+    while (dirname(current) !== current) {
+        if (existsSync(resolve(current, 'skills')) && existsSync(resolve(current, 'schemas/design-context.schema.json')))
+            return current;
+        current = dirname(current);
+    }
+    throw new Error('Kit resources missing; install the complete Tevra package');
+}
+//# sourceMappingURL=resources.js.map

package/dist/packages/filesystem/src/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../../packages/filesystem/src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,OAAO;IACrB,IAAI,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;QACpC,IAAI,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,oCAAoC,CAAC,CAAC;YAAE,OAAO,OAAO,CAAC;QACjI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;AAC/E,CAAC"}

package/dist/packages/performance-qa/src/index.d.ts

@@ -0,0 +1,24 @@
+import type { Check, Config } from '../../contracts/src/index.js';
+export interface PerformanceBudgets {
+    lcpMs: number;
+    cls: number;
+    tbtMs: number;
+}
+export interface PerformanceMetrics {
+    lcpMs: number;
+    cls: number;
+    tbtMs: number;
+}
+export declare const defaultBudgets: PerformanceBudgets;
+export declare function extractMetrics(input: unknown): PerformanceMetrics;
+export declare function performanceChecks(metrics: PerformanceMetrics, budgets: PerformanceBudgets, evidence: string): Check[];
+export declare function auditPerformance(root: string, config: Config, revision: number, options: {
+    allowNetwork: boolean;
+    allowCustomBrowser?: boolean;
+    budgets?: PerformanceBudgets;
+}): Promise<{
+    metrics: PerformanceMetrics;
+    checks: Check[];
+    report: string;
+    html: string;
+}>;

package/dist/packages/performance-qa/src/index.js

@@ -0,0 +1,77 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import { access, mkdir, readFile } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { chromium } from 'playwright';
+import { redact, safePath, withLock, writeAtomic, writeJSON } from '../../filesystem/src/index.js';
+export const defaultBudgets = { lcpMs: 2500, cls: 0.1, tbtMs: 200 };
+function record(value) { return typeof value === 'object' && value !== null && !Array.isArray(value); }
+export function extractMetrics(input) {
+    if (!record(input) || !record(input.audits))
+        throw new Error('Invalid Lighthouse report: missing audits');
+    if (input.runtimeError)
+        throw new Error('Lighthouse reported a runtime error; metrics are unverified');
+    const audits = input.audits;
+    function metric(name) {
+        const audit = audits[name];
+        if (!record(audit) || audit.errorMessage || typeof audit.numericValue !== 'number' || !Number.isFinite(audit.numericValue) || audit.numericValue < 0)
+            throw new Error(`Missing or invalid Lighthouse metric: ${name}`);
+        return audit.numericValue;
+    }
+    return { lcpMs: metric('largest-contentful-paint'), cls: metric('cumulative-layout-shift'), tbtMs: metric('total-blocking-time') };
+}
+export function performanceChecks(metrics, budgets, evidence) {
+    return ['lcpMs', 'cls', 'tbtMs'].map(name => {
+        const budget = budgets[name];
+        const value = metrics[name];
+        if (!Number.isFinite(budget) || budget < 0 || !Number.isFinite(value) || value < 0)
+            throw new Error(`Invalid performance metric or budget: ${name}`);
+        return { id: `performance-${name}`, category: 'performance', kind: 'deterministic', status: value <= budget ? 'passed' : 'failed', severity: 'major', evidence: [evidence], issue: `${name}: ${value}; laboratory budget: ${budget}`, component: 'audited navigation', correction: 'Inspect the saved Lighthouse diagnostics; repeat under equivalent conditions.' };
+    });
+}
+export async function auditPerformance(root, config, revision, options) {
+    if (!options.allowNetwork)
+        throw new Error('Lighthouse loads the target and its resources; review the application and pass --allow-network explicitly');
+    if (config.browser.executablePath && !options.allowCustomBrowser)
+        throw new Error('Custom browser requires --allow-custom-browser');
+    const budgets = options.budgets ?? defaultBudgets;
+    for (const value of Object.values(budgets))
+        if (!Number.isFinite(value) || value < 0)
+            throw new Error('Invalid performance budgets');
+    const target = new URL(config.baseURL);
+    if (!config.permittedOrigins.includes(target.origin) || target.username || target.password || !['http:', 'https:'].includes(target.protocol))
+        throw new Error('Performance URL must use an explicitly permitted origin without credentials');
+    const executable = config.browser.executablePath ?? (config.browser.channel === 'chrome' && process.platform === 'darwin' ? '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' : chromium.executablePath());
+    await access(executable);
+    return withLock(root, '.tevra/performance.lock', async () => {
+        const id = randomUUID();
+        const directory = `.tevra/artifacts/performance/${id}`;
+        await mkdir(await safePath(root, directory), { recursive: true });
+        const output = await safePath(root, `${directory}/lighthouse`);
+        const report = `${directory}/lighthouse.report.json`;
+        const html = `${directory}/lighthouse.report.html`;
+        await writeJSON(root, '.tevra/artifacts/performance/attempt.json', { status: 'running', id, contextRevision: revision });
+        try {
+            const cli = resolve(dirname(fileURLToPath(import.meta.resolve('lighthouse'))), '../cli/index.js');
+            await promisify(execFile)(process.execPath, [cli, target.href, '--only-categories=performance', '--output=json', '--output=html', `--output-path=${output}`, '--chrome-flags=--headless', '--quiet', '--enable-error-reporting=false'], {
+                cwd: root, env: { ...process.env, CHROME_PATH: executable }, timeout: 120000, maxBuffer: 1024 * 1024, windowsHide: true
+            });
+            const raw = JSON.parse(await readFile(await safePath(root, report), 'utf8'));
+            const metrics = extractMetrics(raw);
+            await writeAtomic(root, report, redact(JSON.stringify(raw, null, 2)));
+            await writeAtomic(root, html, redact(await readFile(await safePath(root, html), 'utf8')));
+            const checks = performanceChecks(metrics, budgets, report);
+            const result = { metrics, checks, report, html };
+            await writeJSON(root, `${directory}/summary.json`, { ...result, contextRevision: revision, budgets, measurement: 'laboratory', caveat: 'Navigation TBT is not real-user INP. A single run does not establish a field regression.' });
+            await writeJSON(root, '.tevra/artifacts/performance/attempt.json', { status: 'passed', id, contextRevision: revision, summary: `${directory}/summary.json` });
+            return result;
+        }
+        catch (error) {
+            await writeJSON(root, '.tevra/artifacts/performance/attempt.json', { status: 'failed', id, contextRevision: revision, error: redact(error instanceof Error ? error.message : String(error)) });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/packages/performance-qa/src/index.js.map

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

package/dist/packages/quality-engine/src/html.d.ts

@@ -0,0 +1,2 @@
+import type { QualityReport } from '../../contracts/src/index.js';
+export declare function htmlReport(report: QualityReport): string;

package/dist/packages/quality-engine/src/html.js

@@ -0,0 +1,15 @@
+import { redact } from '../../filesystem/src/index.js';
+function escape(value) {
+    return redact(value).replace(/&/gu, '&amp;').replace(/</gu, '&lt;').replace(/>/gu, '&gt;').replace(/"/gu, '&quot;').replace(/'/gu, '&#39;');
+}
+function artifact(path) {
+    if (/^[a-z][a-z0-9+.-]*:|^[\\/]|[?#\u0000-\u001f]/iu.test(path) || path.split(/[\\/]/u).some(part => part === '..' || part === '.' || !part))
+        return escape(path);
+    const href = `../../${path.split('/').map(encodeURIComponent).join('/')}`;
+    return `<a href="${escape(href)}">${escape(path)}</a>${/\.png$/iu.test(path) ? `<br><img src="${escape(href)}" alt="Screenshot evidence" loading="lazy">` : ''}`;
+}
+export function htmlReport(report) {
+    const rows = report.checks.map(check => `<tr><th scope="row">${escape(check.id)}</th><td>${escape(check.kind)}</td><td>${escape(check.status)}</td><td>${escape(check.severity)}</td><td>${escape(check.component)}</td><td>${escape(check.issue)}</td><td>${check.evidence.map(artifact).join('<br>')}</td><td>${escape(check.correction)}</td></tr>`).join('');
+    return `<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src 'self'; style-src 'unsafe-inline'; base-uri 'none'"><title>Tevra quality report</title><style>body{font:16px/1.5 system-ui;margin:2rem;color:#18251f;background:#fff}table{border-collapse:collapse;width:100%}th,td{padding:.5rem;border:1px solid #bbb;text-align:left;vertical-align:top}img{max-width:24rem;max-height:20rem}section{overflow:auto}a{color:#165b42}</style><body><main><h1>Tevra quality report</h1><p>Status: <strong>${escape(report.status)}</strong>. Context revision: ${report.contextRevision}.</p><p>Score: ${report.score === null ? 'unscored / incomplete evidence' : `${report.score}/100 (evidence-labeled judgment)`}</p><p>Blockers: ${escape(report.blockers.join(', ') || 'none')}</p><p>Missing evidence: ${escape(report.missing.join(', ') || 'none')}</p><section aria-label="Quality findings"><table><thead><tr>${['Check', 'Evidence kind', 'Status', 'Severity', 'Component', 'Issue', 'Evidence', 'Correction'].map(title => `<th scope="col">${title}</th>`).join('')}</tr></thead><tbody>${rows}</tbody></table></section><h2>Verification limits</h2><ul>${report.limits.map(limit => `<li>${escape(limit)}</li>`).join('')}</ul></main></body></html>`;
+}
+//# sourceMappingURL=html.js.map

package/dist/packages/quality-engine/src/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../../../packages/quality-engine/src/html.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC9I,CAAC;AACD,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,gDAAgD,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IAClK,MAAM,IAAI,GAAG,SAAS,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1E,OAAO,YAAY,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACnK,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjW,OAAO,snBAAsnB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gCAAgC,MAAM,CAAC,eAAe,kBAAkB,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,kCAAkC,oBAAoB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,4BAA4B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,gEAAgE,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,mBAAmB,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,uBAAuB,IAAI,6DAA6D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,4BAA4B,CAAC;AAC31C,CAAC"}

package/dist/packages/quality-engine/src/index.d.ts

@@ -0,0 +1,3 @@
+import type { Config, QualityReport } from '../../contracts/src/index.js';
+export declare function evaluateQuality(input: unknown, config: Config, contextRevision: number): QualityReport;
+export declare function markdownReport(report: QualityReport): string;

package/dist/packages/quality-engine/src/index.js

@@ -0,0 +1,45 @@
+import { categories } from '../../contracts/src/index.js';
+import { validate } from '../../design-context/src/validation.js';
+import { redact } from '../../filesystem/src/index.js';
+export function evaluateQuality(input, config, contextRevision) {
+    const checks = validate('checks.schema.json', input);
+    if (new Set(checks.map(check => check.id)).size !== checks.length)
+        throw new Error('Quality check IDs must be unique');
+    for (const check of checks)
+        if (check.status !== 'unverified' && !check.evidence.length)
+            throw new Error(`Executed check requires evidence: ${check.id}`);
+    for (const check of checks)
+        if (check.score !== undefined && check.score < 3 && (!check.issue.trim() || !check.correction.trim()))
+            throw new Error(`Low score requires a finding and correction: ${check.id}`);
+    const blockers = checks.filter(check => check.status === 'failed' && (check.severity === 'critical' || config.requiredChecks.includes(check.id))).map(check => check.id);
+    const missing = config.requiredChecks.filter(id => !checks.some(check => check.id === id && check.status === 'passed'));
+    let weighted = 0;
+    let complete = true;
+    for (const category of categories) {
+        const weight = config.weights[category] ?? 0;
+        if (weight === 0)
+            continue;
+        const scored = checks.filter(check => check.category === category && check.score !== undefined && check.status !== 'unverified');
+        if (!scored.length) {
+            complete = false;
+            if (config.thresholds.minScore > 0)
+                missing.push(`score:${category}`);
+            continue;
+        }
+        weighted += Math.min(...scored.map(check => check.score ?? 0)) / 4 * weight;
+    }
+    const score = complete ? Math.round(weighted * 100) / 100 : null;
+    if (score !== null && score < config.thresholds.minScore)
+        blockers.push('weighted-score');
+    return validate('quality-report.schema.json', {
+        version: 1, createdAt: new Date().toISOString(), status: blockers.length || missing.length ? 'FAIL' : 'PASS', score,
+        blockers: [...new Set(blockers)], missing: [...new Set(missing)], checks,
+        limits: ['AI/human scores are subjective judgments, not objective measurements.', 'Pixel differences measure visual change, not usability.', 'Automated accessibility checks do not establish full WCAG compliance.', 'Unexecuted manual, screen-reader, native and performance checks remain unverified.'], contextRevision
+    });
+}
+function cell(value) { return redact(value).replace(/([\\|\[\]()`])/gu, '\\$1').replace(/</gu, '&lt;').replace(/>/gu, '&gt;').replace(/[\r\n]/gu, ' '); }
+export function markdownReport(report) {
+    const rows = report.checks.map(check => `| ${cell(check.id)} | ${check.kind} | ${check.status} | ${check.severity} | ${cell(check.component)} | ${cell(check.issue)} | ${cell(check.evidence.join(', '))} | ${cell(check.correction)} |`);
+    return redact(`# Tevra quality report\n\nStatus: **${report.status}** · Context revision: ${report.contextRevision}\n\nWeighted score: ${report.score === null ? 'unscored / incomplete evidence' : `${report.score}/100 (evidence-labeled judgment)`}\n\nBlockers: ${report.blockers.join(', ') || 'none'}\n\nMissing required evidence: ${report.missing.join(', ') || 'none'}\n\n| Check | Evidence kind | Status | Severity | Component | Issue | Evidence | Correction |\n| --- | --- | --- | --- | --- | --- | --- | --- |\n${rows.join('\n')}\n\n## Verification limits\n\n${report.limits.map(limit => `- ${limit}`).join('\n')}\n`);
+}
+//# sourceMappingURL=index.js.map

package/dist/packages/quality-engine/src/index.js.map

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

package/dist/packages/registry/src/index.d.ts

@@ -0,0 +1,49 @@
+export interface RegistrySkill {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    capabilities: string[];
+    activation: {
+        intents: string[];
+    };
+    inputs: string[];
+    outputs: string[];
+    dependencies: string[];
+    conflicts: string[];
+    frameworks: string[];
+    platforms: string[];
+    agents: string[];
+    source: {
+        type: string;
+        references: string[];
+    };
+    license: string;
+    priority: number;
+    estimatedCost: {
+        minutes: number;
+        contextTokens: number;
+    };
+    requiredTools: string[];
+    validation: string[];
+    entrypoint: string;
+}
+export interface Registry {
+    version: 1;
+    skills: RegistrySkill[];
+}
+export interface Selection {
+    skills: RegistrySkill[];
+    owners: Record<string, string>;
+    duplicates: Record<string, string[]>;
+}
+export declare function validateRegistry(input: unknown): Registry;
+export declare function loadRegistry(extensionFiles?: string[]): Promise<Registry>;
+export declare function selectCapabilities(registryInput: unknown, capabilities: string[], options?: {
+    framework?: string;
+    platform?: string;
+    agent?: string;
+    overrides?: Record<string, string>;
+}): Selection;
+export declare function registryGraph(registry: Registry): string;
+export declare function validateBundledProvenance(registry: Registry): Promise<void>;