tevra-design-kit 0.0.0-stage → 1.0.0

package/dist/packages/core/src/analyze.js

@@ -0,0 +1,46 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { isMissing, safePath } from '../../filesystem/src/index.js';
+export async function analyzeProject(root) {
+    let manifest = {};
+    try {
+        manifest = JSON.parse(await readFile(await safePath(root, 'package.json'), 'utf8'));
+    }
+    catch (error) {
+        if (!isMissing(error))
+            throw error;
+    }
+    const dependencies = new Set();
+    if (manifest && typeof manifest === 'object')
+        for (const section of ['dependencies', 'devDependencies']) {
+            if (section in manifest) {
+                const value = Reflect.get(manifest, section);
+                if (value && typeof value === 'object')
+                    for (const key of Object.keys(value))
+                        dependencies.add(key);
+            }
+        }
+    const framework = ['next', '@sveltejs/kit', 'expo', 'react-native', 'vue', 'react'].find(name => dependencies.has(name)) ?? 'unknown';
+    const styling = ['tailwindcss', 'styled-components', '@emotion/react'].filter(name => dependencies.has(name));
+    const systemFiles = [];
+    const instructions = [];
+    async function scan(directory, depth) {
+        if (depth > 3 || systemFiles.length >= 200)
+            return;
+        for (const entry of await readdir(directory, { withFileTypes: true })) {
+            if (entry.isSymbolicLink() || /^(node_modules|dist|build|\.git|\.next|\.svelte-kit)$/u.test(entry.name))
+                continue;
+            const full = resolve(directory, entry.name);
+            const local = full.slice(root.length + 1);
+            if (entry.isDirectory())
+                await scan(full, depth + 1);
+            else if (/^(CLAUDE|AGENTS)\.md$/u.test(entry.name))
+                instructions.push(local);
+            else if (/(token|theme|global|design.system|component).*\.(css|json|md|tsx|ts|vue|svelte)$/iu.test(entry.name))
+                systemFiles.push(local);
+        }
+    }
+    await scan(root, 0);
+    return { framework: framework === 'next' ? 'nextjs' : framework === '@sveltejs/kit' ? 'sveltekit' : framework, styling: styling.length ? styling : ['inspect-css'], systemFiles, instructions };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/packages/core/src/analyze.js.map

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

package/dist/packages/core/src/config.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from '../../contracts/src/index.js';
+export declare const defaultConfig: Config;
+export declare function validateConfig(value: unknown): Config;
+export declare function loadConfig(root: string): Promise<Config>;

package/dist/packages/core/src/config.js

@@ -0,0 +1,39 @@
+import { validate } from '../../design-context/src/validation.js';
+import { readJSON } from '../../filesystem/src/index.js';
+export const defaultConfig = {
+    version: 1, baseURL: 'http://127.0.0.1:4173', permittedOrigins: ['http://127.0.0.1:4173'],
+    viewports: [{ name: 'mobile', width: 390, height: 844 }, { name: 'tablet', width: 768, height: 1024 }, { name: 'laptop', width: 1280, height: 800 }, { name: 'desktop', width: 1440, height: 900 }],
+    routes: [{ name: 'home', path: '/', states: [{ name: 'default', actions: [], masks: [] }] }],
+    browser: {}, timeoutMs: 15000, thresholds: { diffRatio: 0.01, pixelSensitivity: 0.1, minScore: 75 },
+    weights: { hierarchy: 15, typography: 10, layout: 15, consistency: 10, responsive: 15, accessibility: 15, interaction: 0, functional: 10, performance: 10 },
+    requiredChecks: ['visual-diff', 'axe', 'overflow', 'functional-tests'], maxRefinements: 2
+};
+export function validateConfig(value) {
+    const config = validate('config.schema.json', value);
+    const base = new URL(config.baseURL);
+    if (!['http:', 'https:'].includes(base.protocol) || base.username || base.password || base.search || base.hash)
+        throw new Error('baseURL must be an HTTP(S) URL without credentials, query or fragment');
+    for (const origin of config.permittedOrigins)
+        if (new URL(origin).origin !== origin)
+            throw new Error(`Expected exact permitted origin: ${origin}`);
+    if (!config.permittedOrigins.includes(base.origin))
+        throw new Error('baseURL origin is not explicitly permitted');
+    for (const route of config.routes)
+        if (!config.permittedOrigins.includes(new URL(route.path, config.baseURL).origin))
+            throw new Error(`Route escapes permitted origins: ${route.name}`);
+    for (const [label, names] of [['viewport', config.viewports.map(viewport => viewport.name)], ['route', config.routes.map(route => route.name)], ...config.routes.map(route => [`state in ${route.name}`, route.states.map(state => state.name)])]) {
+        if (new Set(names).size !== names.length)
+            throw new Error(`Duplicate ${label} names`);
+    }
+    for (const route of config.routes)
+        for (const state of route.states)
+            for (const action of state.actions) {
+                if ((action.type === 'fill' || action.type === 'press' || action.type === 'expect-text') && action.value === undefined)
+                    throw new Error(`${action.type} action requires a value`);
+            }
+    if (Math.abs(Object.values(config.weights).reduce((sum, weight) => sum + weight, 0) - 100) > 0.001)
+        throw new Error('Quality weights must sum to 100');
+    return config;
+}
+export async function loadConfig(root) { return validateConfig(await readJSON(root, '.tevra/config.json')); }
+//# sourceMappingURL=config.js.map

package/dist/packages/core/src/config.js.map

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

package/dist/packages/core/src/install.d.ts

@@ -0,0 +1,13 @@
+export declare const agentDirectories: {
+    readonly codex: ".agents/skills";
+    readonly claude: ".claude/skills";
+    readonly cursor: ".cursor/skills";
+    readonly kiro: ".kiro/skills";
+    readonly gemini: ".gemini/skills";
+    readonly copilot: ".github/skills";
+    readonly opencode: ".opencode/skills";
+    readonly windsurf: ".windsurf/skills";
+};
+export type Agent = keyof typeof agentDirectories;
+export declare function isAgent(name: string): name is Agent;
+export declare function installSkills(root: string, agents: Agent[], dryRun?: boolean): Promise<string[]>;

package/dist/packages/core/src/install.js

@@ -0,0 +1,69 @@
+import { lstat, readFile, readdir } from 'node:fs/promises';
+import { relative, resolve } from 'node:path';
+import { isMissing, safePath, withLock, writeAtomic } from '../../filesystem/src/index.js';
+import { kitRoot } from '../../filesystem/src/resources.js';
+import { discoverSkills } from './skills.js';
+export const agentDirectories = {
+    codex: '.agents/skills', claude: '.claude/skills', cursor: '.cursor/skills', kiro: '.kiro/skills',
+    gemini: '.gemini/skills', copilot: '.github/skills', opencode: '.opencode/skills', windsurf: '.windsurf/skills'
+};
+export function isAgent(name) { return Object.hasOwn(agentDirectories, name); }
+async function filesBelow(directory) {
+    const found = [];
+    for (const entry of await readdir(directory, { withFileTypes: true })) {
+        if (entry.isSymbolicLink())
+            throw new Error(`Symlink in installation source: ${entry.name}`);
+        const full = resolve(directory, entry.name);
+        if (entry.isDirectory())
+            found.push(...await filesBelow(full));
+        else if (entry.isFile())
+            found.push(full);
+    }
+    return found;
+}
+export async function installSkills(root, agents, dryRun = false) {
+    const source = resolve(kitRoot(), 'skills');
+    const skills = await discoverSkills(source);
+    const writes = [];
+    for (const agent of new Set(agents)) {
+        const base = agentDirectories[agent];
+        if (!base)
+            throw new Error(`Unsupported agent: ${agent}`);
+        for (const skill of skills) {
+            const directory = resolve(source, skill.name);
+            for (const file of await filesBelow(directory)) {
+                const name = `${base}/${skill.name}/${relative(directory, file).split('\\').join('/')}`;
+                const destination = await safePath(root, name);
+                const bytes = await readFile(file);
+                try {
+                    const existing = await lstat(destination);
+                    if (!existing.isFile() || !(await readFile(destination)).equals(bytes))
+                        throw new Error(`Installation conflict; preserve local file: ${name}`);
+                }
+                catch (error) {
+                    if (!isMissing(error))
+                        throw error;
+                }
+                writes.push({ name, bytes });
+            }
+        }
+    }
+    if (!dryRun)
+        await withLock(root, '.tevra/install.lock', async () => {
+            for (const write of writes) {
+                const destination = await safePath(root, write.name);
+                try {
+                    if (!(await readFile(destination)).equals(write.bytes))
+                        throw new Error(`Installation conflict; preserve local file: ${write.name}`);
+                }
+                catch (error) {
+                    if (!isMissing(error))
+                        throw error;
+                }
+            }
+            for (const write of writes)
+                await writeAtomic(root, write.name, write.bytes);
+        });
+    return writes.map(write => write.name);
+}
+//# sourceMappingURL=install.js.map

package/dist/packages/core/src/install.js.map

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

package/dist/packages/core/src/router.d.ts

@@ -0,0 +1,12 @@
+import type { Registry } from '../../registry/src/index.js';
+import type { Plan } from '../../contracts/src/index.js';
+export interface RouteOptions {
+    mode: Plan['mode'];
+    maxSteps: number;
+    maxMinutes: number;
+    maxRefinements: number;
+    contextRevision: number;
+    framework?: string;
+    platform?: string;
+}
+export declare function planWorkflow(request: string, options: RouteOptions, extensionRegistry?: Registry): Plan;

package/dist/packages/core/src/router.js

@@ -0,0 +1,90 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { kitRoot } from '../../filesystem/src/resources.js';
+import { selectCapabilities, validateRegistry } from '../../registry/src/index.js';
+import { randomUUID } from 'node:crypto';
+export function planWorkflow(request, options, extensionRegistry) {
+    if (!request.trim())
+        throw new Error('A non-empty user request is required');
+    if (!Number.isInteger(options.maxSteps) || options.maxSteps < 1 || options.maxSteps > 100 || !Number.isInteger(options.contextRevision) || options.contextRevision < 0)
+        throw new Error('Invalid step budget or context revision');
+    const text = request.toLocaleLowerCase();
+    // Whole-word match so "form" does not fire on "performance" or "information".
+    const has = (terms) => new RegExp(`(?<!\\p{L})(?:${terms})(?!\\p{L})`, 'u').test(text);
+    const screenshot = has('screenshots?|ảnh chụp|reference images?');
+    const redesign = has('redesign|improve|fix|restyle|cải thiện|thiết kế lại|sửa');
+    const component = has('cards?|buttons?|headers?|navigation|forms?|tables?|components?|thẻ|nút|biểu mẫu');
+    let selected;
+    if (has('performance|lighthouse|web vitals|core web vitals|hiệu năng'))
+        selected = ['performance-qa'];
+    else if (has('browser tests?|browser testing|e2e|functional regression'))
+        selected = ['browser-testing'];
+    else if (has('source review|code review|frontend review'))
+        selected = ['frontend-review'];
+    else if (has('accessib\\p{L}*|wcag|a11y|truy cập') && !redesign)
+        selected = ['accessibility-qa'];
+    else if (has('motion|animations?|micro.interactions?|chuyển động'))
+        selected = ['interaction-motion', 'ui-builder', 'visual-review', 'accessibility-qa'];
+    else if (has('responsive|overflow|mobile layout|di động'))
+        selected = ['responsive-design', 'ui-builder', 'visual-review', 'accessibility-qa'];
+    else if (has('tokens?|design system|hệ thống thiết kế'))
+        selected = ['design-research', 'design-direction', 'design-system'];
+    else if (screenshot)
+        selected = ['design-direction', 'ui-builder', 'responsive-design', 'visual-review', 'accessibility-qa'];
+    else if (redesign && component)
+        selected = ['ui-redesign', 'ui-builder', 'visual-review'];
+    else if (redesign)
+        selected = ['ui-redesign', 'design-direction', 'ui-builder', 'responsive-design', 'visual-review', 'accessibility-qa'];
+    else if (has('review|compare|audit|kiểm tra'))
+        selected = ['visual-review', 'accessibility-qa'];
+    else
+        selected = ['design-research', 'design-direction', 'design-system', 'ui-builder', 'responsive-design', 'visual-review', 'accessibility-qa'];
+    // Quick mode trims supporting steps but keeps responsive-design when it owns the request.
+    if (options.mode === 'quick')
+        selected = selected.filter((skill, index) => skill !== 'design-research' && (skill !== 'responsive-design' || index === 0));
+    if (options.mode === 'full' && !component && !selected.includes('accessibility-qa'))
+        selected.push('accessibility-qa');
+    if (options.mode === 'full' && !['performance-qa', 'browser-testing', 'frontend-review'].some(name => selected.length === 1 && selected.includes(name))) {
+        for (const name of ['frontend-review', 'browser-testing', 'performance-qa'])
+            if (!selected.includes(name))
+                selected.push(name);
+    }
+    const registry = extensionRegistry ?? validateRegistry(JSON.parse(readFileSync(resolve(kitRoot(), 'registry/skills.json'), 'utf8')));
+    const builtinCapabilities = {
+        'design-research': 'ux.research', 'design-direction': 'visual.direction', 'design-system': 'design.tokens',
+        'ui-builder': 'frontend.implementation', 'ui-redesign': 'ui.redesign', 'responsive-design': 'responsive.design',
+        'interaction-motion': 'interaction.motion', 'visual-review': 'visual.regression', 'accessibility-qa': 'accessibility',
+        'performance-qa': 'performance', 'browser-testing': 'browser.testing', 'frontend-review': 'frontend.review'
+    };
+    const requested = selected.map(name => { const capability = builtinCapabilities[name]; if (!capability)
+        throw new Error(`Unknown capability for ${name}`); return capability; });
+    const resolution = selectCapabilities(registry, requested, { ...(options.framework ? { framework: options.framework } : {}), ...(options.platform ? { platform: options.platform } : {}) });
+    const ordered = [];
+    const added = new Set();
+    function add(id) {
+        if (added.has(id))
+            return;
+        const entry = resolution.skills.find(candidate => candidate.id === id);
+        if (!entry)
+            throw new Error(`Unresolved registry skill: ${id}`);
+        for (const dependency of entry.dependencies)
+            add(dependency);
+        added.add(id);
+        ordered.push(entry.name);
+    }
+    for (const capability of requested) {
+        const owner = resolution.owners[capability];
+        if (owner)
+            add(owner);
+    }
+    selected = ordered;
+    if (selected.length > options.maxSteps)
+        throw new Error(`Workflow needs ${selected.length} steps; budget permits ${options.maxSteps}. Narrow the task or increase the budget.`);
+    if (!Number.isInteger(options.maxMinutes) || options.maxMinutes < 1 || options.maxMinutes > 1440 || !Number.isInteger(options.maxRefinements) || options.maxRefinements < 0 || options.maxRefinements > 10)
+        throw new Error('Invalid execution budget');
+    return { version: 1, id: randomUUID(), request, mode: options.mode, contextVersion: '2.0', contextRevision: options.contextRevision, createdAt: new Date().toISOString(),
+        budget: { maxSteps: options.maxSteps, maxMinutes: options.maxMinutes, maxRefinements: options.mode === 'quick' ? 0 : options.maxRefinements },
+        steps: selected.map((skill, index) => ({ skill, dependsOn: index > 0 ? selected.slice(index - 1, index) : [], status: 'pending', attempts: 0, evidence: [] })),
+        approvalRequired: /transformative|shared tokens|brand migration|đổi thương hiệu/u.test(text), approvedBy: null };
+}
+//# sourceMappingURL=router.js.map

package/dist/packages/core/src/router.js.map

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

package/dist/packages/core/src/search.d.ts

@@ -0,0 +1,12 @@
+export interface Pattern {
+    id: string;
+    category: string;
+    tags: string[];
+    recommendation: string;
+    source: string;
+    confidence: string;
+    license: string;
+}
+export declare function searchPatterns(query: string, category?: string, limit?: number): Promise<(Pattern & {
+    score: number;
+})[]>;

package/dist/packages/core/src/search.js

@@ -0,0 +1,31 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { kitRoot } from '../../filesystem/src/resources.js';
+function terms(text) { return text.toLocaleLowerCase().match(/[\p{L}\p{N}]+/gu) ?? []; }
+export async function searchPatterns(query, category, limit = 5) {
+    if (!query.trim() || !Number.isInteger(limit) || limit < 1 || limit > 20)
+        throw new Error('Search needs a query and a result limit between 1 and 20');
+    const input = JSON.parse(await readFile(resolve(kitRoot(), 'references/ux-patterns/catalog.json'), 'utf8'));
+    if (!Array.isArray(input))
+        throw new Error('Invalid bundled pattern catalog');
+    const patterns = input.map((entry) => {
+        if (!entry || typeof entry !== 'object' || !('id' in entry) || !('category' in entry) || !('tags' in entry) || !('recommendation' in entry) || !('source' in entry) || !('confidence' in entry) || !('license' in entry) || ![entry.id, entry.category, entry.recommendation, entry.source, entry.confidence, entry.license].every(value => typeof value === 'string') || !Array.isArray(entry.tags) || !entry.tags.every(value => typeof value === 'string'))
+            throw new Error('Invalid pattern catalog record');
+        return entry;
+    }).filter(pattern => !category || pattern.category === category);
+    const documents = patterns.map(pattern => terms(`${pattern.category} ${pattern.tags.join(' ')} ${pattern.recommendation}`));
+    const averageLength = documents.reduce((sum, tokens) => sum + tokens.length, 0) / (documents.length || 1);
+    const queryTerms = [...new Set(terms(query))];
+    const frequencies = new Map(queryTerms.map(term => [term, documents.filter(tokens => tokens.includes(term)).length]));
+    return patterns.map((pattern, index) => {
+        const tokens = documents[index] ?? [];
+        const score = queryTerms.reduce((sum, term) => {
+            const frequency = tokens.filter(token => token === term).length;
+            const matched = frequencies.get(term) ?? 0;
+            const inverseFrequency = Math.log(1 + (documents.length - matched + 0.5) / (matched + 0.5));
+            return sum + inverseFrequency * frequency * 2.2 / (frequency + 1.2 * (0.25 + 0.75 * tokens.length / averageLength));
+        }, 0);
+        return { ...pattern, score };
+    }).filter(pattern => pattern.score > 0).sort((a, b) => b.score - a.score || a.id.localeCompare(b.id)).slice(0, limit);
+}
+//# sourceMappingURL=search.js.map

package/dist/packages/core/src/search.js.map

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

package/dist/packages/core/src/skills.d.ts

@@ -0,0 +1,7 @@
+import type { SkillName } from '../../contracts/src/index.js';
+export interface Skill {
+    name: SkillName;
+    description: string;
+    path: string;
+}
+export declare function discoverSkills(directory: string): Promise<Skill[]>;

package/dist/packages/core/src/skills.js

@@ -0,0 +1,36 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { parseDocument } from 'yaml';
+import { safePath } from '../../filesystem/src/index.js';
+export async function discoverSkills(directory) {
+    const discovered = [];
+    for (const entry of await readdir(directory, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const path = await safePath(directory, `${entry.name}/SKILL.md`);
+        const content = await readFile(path, 'utf8');
+        const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(content);
+        if (!match?.[1])
+            throw new Error(`Missing YAML frontmatter: ${path}`);
+        const document = parseDocument(match[1], { uniqueKeys: true });
+        if (document.errors.length)
+            throw new Error(`Invalid YAML: ${path}`);
+        const metadata = document.toJS({ maxAliasCount: 0 });
+        if (!metadata || typeof metadata !== 'object' || !('name' in metadata) || !('description' in metadata))
+            throw new Error(`Missing skill metadata: ${path}`);
+        const name = typeof metadata.name === 'string' && /^[a-z][a-z0-9-]{0,63}$/u.test(metadata.name) ? metadata.name : undefined;
+        if (!name || name !== entry.name || typeof metadata.description !== 'string' || !metadata.description.trim() || metadata.description.length > 1024)
+            throw new Error(`Invalid skill identity: ${entry.name}`);
+        for (const link of content.matchAll(/\]\(([^)#]+)(?:#[^)]*)?\)/gu)) {
+            const target = link[1];
+            if (!target || /^[a-z]+:/iu.test(target))
+                continue;
+            await readFile(await safePath(resolve(directory, entry.name), target));
+        }
+        if (discovered.some(skill => skill.name === name))
+            throw new Error(`Duplicate skill: ${name}`);
+        discovered.push({ name, description: metadata.description, path });
+    }
+    return discovered.sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=skills.js.map

package/dist/packages/core/src/skills.js.map

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

package/dist/packages/core/src/workflow.d.ts

@@ -0,0 +1,3 @@
+import type { Handoff, Plan, SkillName, Status } from '../../contracts/src/index.js';
+export declare function assertHandoff(value: unknown, contextRevision: number, active: Handoff[]): Handoff;
+export declare function transitionPlan(root: string, path: string, skill: SkillName, status: Status, evidence: string[], currentRevision: number): Promise<Plan>;

package/dist/packages/core/src/workflow.js

@@ -0,0 +1,73 @@
+import { stat } from 'node:fs/promises';
+import { validate } from '../../design-context/src/validation.js';
+import { readJSON, safePath, withLock, writeJSON } from '../../filesystem/src/index.js';
+import { loadContext } from '../../design-context/src/index.js';
+export function assertHandoff(value, contextRevision, active) {
+    const handoff = validate('handoff.schema.json', value);
+    const canonical = (file) => {
+        const normalized = file.replaceAll('\\', '/').replace(/\/$/u, '');
+        if (!normalized || normalized.startsWith('/') || /^[a-z]:/iu.test(normalized) || normalized.split('/').some(segment => segment === '..' || segment === '.' || !segment))
+            throw new Error(`Unsafe handoff path: ${file}`);
+        return normalized;
+    };
+    handoff.files = handoff.files.map(canonical);
+    handoff.inputs = handoff.inputs.map(canonical);
+    handoff.outputs = handoff.outputs.map(canonical);
+    handoff.evidence = handoff.evidence.map(canonical);
+    if (handoff.contextRevision !== contextRevision)
+        throw new Error('Handoff context revision is stale');
+    if (active.some(existing => existing.taskId === handoff.taskId && existing.owner !== handoff.owner))
+        throw new Error('Task ownership transfer requires explicit coordination');
+    for (const existing of active.filter(task => ['pending', 'running', 'awaiting-approval', 'blocked'].includes(task.status) && task.taskId !== handoff.taskId)) {
+        if (handoff.files.some(file => existing.files.map(canonical).some(other => file === other || file.startsWith(`${other}/`) || other.startsWith(`${file}/`))))
+            throw new Error(`Conflicting file ownership with ${existing.taskId}`);
+    }
+    if (handoff.status === 'passed' && !handoff.evidence.length)
+        throw new Error('Passed handoff requires validation evidence');
+    if (handoff.status === 'failed' && !handoff.error)
+        throw new Error('Failed handoff requires error information');
+    return handoff;
+}
+export async function transitionPlan(root, path, skill, status, evidence, currentRevision) {
+    return withLock(root, '.tevra/context.lock', () => withLock(root, '.tevra/workflow.lock', async () => {
+        if ((await loadContext(root)).revision !== currentRevision)
+            throw new Error('Workflow context revision is stale');
+        const plan = validate('plan.schema.json', await readJSON(root, path));
+        if (plan.contextRevision !== currentRevision)
+            throw new Error('Workflow context revision is stale');
+        const step = plan.steps.find(value => value.skill === skill);
+        if (!step)
+            throw new Error(`Skill is outside this workflow: ${skill}`);
+        if (Date.now() > Date.parse(plan.createdAt) + plan.budget.maxMinutes * 60000)
+            throw new Error('Workflow time budget exhausted');
+        if (status === 'running') {
+            if (!['pending', 'failed', 'awaiting-approval', 'blocked'].includes(step.status))
+                throw new Error('Only pending or failed work can start');
+            if (plan.approvalRequired && !plan.approvedBy)
+                throw new Error('Human approval required before starting this high-impact workflow');
+            if (step.dependsOn.some(dependency => plan.steps.find(candidate => candidate.skill === dependency)?.status !== 'passed'))
+                throw new Error('Workflow dependency has not passed');
+            if (step.attempts >= plan.budget.maxRefinements + 1)
+                throw new Error('Maximum refinement count reached');
+            step.attempts++;
+        }
+        else if (status === 'passed' || status === 'failed' || status === 'blocked' || status === 'skipped') {
+            if (step.status !== 'running')
+                throw new Error('Start the step before completing it');
+            if (!evidence.length)
+                throw new Error('Completion or failure requires evidence');
+            for (const artifact of evidence)
+                if (!(await stat(await safePath(root, artifact))).isFile())
+                    throw new Error(`Evidence is not a file: ${artifact}`);
+        }
+        else
+            throw new Error('Supported transitions: running, passed, failed, blocked, skipped');
+        if (status === 'blocked')
+            step.attempts = Math.max(0, step.attempts - 1);
+        step.status = status;
+        step.evidence = evidence;
+        await writeJSON(root, path, plan);
+        return plan;
+    }));
+}
+//# sourceMappingURL=workflow.js.map

package/dist/packages/core/src/workflow.js.map

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

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

@@ -0,0 +1,5 @@
+import type { DesignContext } from '../../contracts/src/index.js';
+export declare const contextPath = ".tevra/design-context.json";
+export declare function createContext(name: string, owner: string): DesignContext;
+export declare function loadContext(root: string): Promise<DesignContext>;
+export declare function updateContext(root: string, candidate: unknown, expectedRevision: number, approveConstraints?: boolean): Promise<DesignContext>;

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

@@ -0,0 +1,41 @@
+import { readJSON, withLock, writeJSON } from '../../filesystem/src/index.js';
+import { validate } from './validation.js';
+import { isDeepStrictEqual } from 'node:util';
+export const contextPath = '.tevra/design-context.json';
+export function createContext(name, owner) {
+    return validate('design-context.v2.schema.json', {
+        version: '2.0', revision: 0, owner, project: { name, framework: 'unknown', styling: 'css' },
+        design: { variance: 5, motionIntensity: 3, visualDensity: 5, theme: 'system', brandPersonality: [] },
+        tokens: { primitive: {}, semantic: {}, component: {}, themes: {}, responsive: {} },
+        constraints: { preserveBrand: true, preserveFunctionality: true, accessibilityTarget: 'WCAG_2_2_AA', approvedScope: [] },
+        decisions: [], assumptions: ['Inspect the existing design system before proposing tokens.'], evidence: []
+    });
+}
+export async function loadContext(root) { return validate('design-context.v2.schema.json', await readJSON(root, contextPath)); }
+export async function updateContext(root, candidate, expectedRevision, approveConstraints = false) {
+    const next = validate('design-context.v2.schema.json', candidate);
+    return withLock(root, '.tevra/context.lock', async () => {
+        const current = await loadContext(root);
+        if (current.revision !== expectedRevision || next.revision !== expectedRevision)
+            throw new Error('Stale context revision; reload before writing');
+        if (current.owner !== next.owner)
+            throw new Error('Context ownership transfer requires an explicit migration');
+        if (!approveConstraints && !isDeepStrictEqual(current.constraints, next.constraints))
+            throw new Error('Constraint changes require explicit --approve-constraints authorization');
+        if (current.approvedDirection?.approved && !isDeepStrictEqual(current.approvedDirection, next.approvedDirection))
+            throw new Error('Approved visual direction is immutable; record a new explicit decision before migration');
+        if (current.brand && !isDeepStrictEqual(current.brand, next.brand) && !approveConstraints)
+            throw new Error('Brand changes require explicit --approve-constraints authorization');
+        for (const approved of current.decisions.filter(decision => decision.approved)) {
+            const replacement = next.decisions.find(decision => decision.id === approved.id);
+            if (!isDeepStrictEqual(replacement, approved))
+                throw new Error(`Approved decision is immutable: ${approved.id}`);
+        }
+        if (new Set(next.decisions.map(decision => decision.id)).size !== next.decisions.length)
+            throw new Error('Duplicate decision identifiers');
+        const updated = { ...next, revision: expectedRevision + 1 };
+        await writeJSON(root, contextPath, updated);
+        return updated;
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,2 @@
+import type { DesignContext } from '../../contracts/src/index.js';
+export declare function migrateContext(input: unknown, owner: string): DesignContext;

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

@@ -0,0 +1,27 @@
+import { createContext } from './index.js';
+import { validate } from './validation.js';
+export function migrateContext(input, owner) {
+    if (!input || typeof input !== 'object')
+        throw new Error('Context must be an object');
+    if ('version' in input && input.version === '2.0')
+        return validate('design-context.v2.schema.json', input);
+    if ('version' in input && input.version === '1.0') {
+        const original = validate('legacy/design-context.master-v1.schema.json', input);
+        const migrated = createContext(original.project.name, owner);
+        migrated.project = original.project;
+        migrated.design = original.design;
+        migrated.tokens.primitive = Object.fromEntries(Object.entries(original.tokens).flatMap(([group, tokens]) => Object.entries(tokens).map(([key, value]) => [`${group}.${key}`, value])));
+        migrated.constraints = { ...original.constraints, approvedScope: [] };
+        migrated.decisions = original.decisions.map((description, index) => ({ id: `imported-${index + 1}`, description, owner, approved: false }));
+        migrated.assumptions = ['Imported version 1.0 without approval metadata; confirm imported decisions explicitly.'];
+        return validate('design-context.v2.schema.json', migrated);
+    }
+    const legacy = validate('legacy/design-context.v1.schema.json', input);
+    const migrated = createContext(legacy.project.name, owner);
+    migrated.tokens.primitive = Object.fromEntries(Object.entries(legacy.tokens).flatMap(([group, tokens]) => Object.entries(tokens).map(([key, value]) => [`${group}.${key}`, value])));
+    migrated.decisions = (legacy.decisions ?? []).map((description, index) => ({ id: `legacy-${index + 1}`, description, approved: false, owner }));
+    migrated.evidence = legacy.project.evidence ?? [];
+    migrated.assumptions = ['Migrated legacy constraints retained as notes; confirm structured scope before implementation.', ...(legacy.constraints ?? [])];
+    return validate('design-context.v2.schema.json', migrated);
+}
+//# sourceMappingURL=migrate.js.map