tevra-design-kit 0.0.0-stage → 1.0.0

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

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

package/dist/packages/cli/src/project-commands.d.ts

@@ -0,0 +1,4 @@
+import type { Agent } from '../../core/src/install.js';
+import type { Arguments } from './arguments.js';
+export declare function agents(value: string): Agent[];
+export declare function projectCommand(args: Arguments, root: string): Promise<unknown>;

package/dist/packages/cli/src/project-commands.js

@@ -0,0 +1,137 @@
+import { access } from 'node:fs/promises';
+import { basename } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { chromium } from 'playwright';
+import { agentDirectories, installSkills, isAgent } from '../../core/src/install.js';
+import { analyzeProject } from '../../core/src/analyze.js';
+import { defaultConfig, loadConfig, validateConfig } from '../../core/src/config.js';
+import { createContext, contextPath, loadContext, updateContext } from '../../design-context/src/index.js';
+import { migrateContext } from '../../design-context/src/migrate.js';
+import { createFoundation, exportTokens } from '../../design-context/src/tokens.js';
+import { validate } from '../../design-context/src/validation.js';
+import { inspectMemory, resetMemory, updateMemory } from '../../design-memory/src/index.js';
+import { isMissing, readJSON, redact, safePath, writeAtomic, writeJSON } from '../../filesystem/src/index.js';
+import { flag, inputPath, numeric } from './arguments.js';
+export function agents(value) {
+    const list = value.split(',');
+    return list.map(name => { if (isAgent(name))
+        return name; throw new Error(`Unknown agent: ${name}. Supported: ${Object.keys(agentDirectories).join(',')}`); });
+}
+async function exists(root, path) {
+    try {
+        await access(await safePath(root, path));
+        return true;
+    }
+    catch (error) {
+        if (isMissing(error))
+            return false;
+        throw error;
+    }
+}
+export async function projectCommand(args, root) {
+    if (args.command === 'init') {
+        let selected = flag(args, 'agents', 'codex');
+        if (!args.flags.yes) {
+            if (!process.stdin.isTTY)
+                throw new Error('Non-interactive setup requires --yes; select --agents explicitly for CI');
+            const prompt = createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                selected = (await prompt.question(`Install for ${Object.keys(agentDirectories).join(',')} [${selected}]: `)).trim() || selected;
+            }
+            finally {
+                prompt.close();
+            }
+        }
+        const targets = agents(selected);
+        const inventory = await analyzeProject(root);
+        if (!await exists(root, '.tevra/config.json'))
+            await writeJSON(root, '.tevra/config.json', await exists(root, 'tevra.config.json') ? validateConfig(await readJSON(root, 'tevra.config.json')) : defaultConfig);
+        if (!await exists(root, contextPath)) {
+            const context = createContext(basename(root), 'project-owner');
+            if (['react', 'nextjs', 'sveltekit', 'vue', 'react-native', 'expo', 'html'].includes(inventory.framework))
+                context.project.framework = inventory.framework;
+            await writeJSON(root, contextPath, context);
+        }
+        if (!await exists(root, '.tevra/memory.json'))
+            await writeJSON(root, '.tevra/memory.json', { version: 1, revision: 0, entries: [] });
+        const installed = args.flags['skip-skills'] ? [] : await installSkills(root, targets);
+        return { root, installed: installed.length, inventory, message: 'Project-local setup complete. Review .tevra/config.json before capture. No git commit or upload was performed.' };
+    }
+    if (args.command === 'doctor') {
+        const config = await loadConfig(root);
+        await loadContext(root);
+        if (config.browser.executablePath && !args.flags['allow-custom-browser'])
+            throw new Error('Custom executable requires --allow-custom-browser after reviewing its provenance');
+        // Outside macOS Playwright resolves the Chrome channel path itself; --launch verifies it.
+        const executable = config.browser.executablePath ?? (config.browser.channel !== 'chrome' ? chromium.executablePath() : process.platform === 'darwin' ? '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' : null);
+        if (executable)
+            await access(executable);
+        let browserVersion = null;
+        if (args.flags.launch) {
+            const browser = await chromium.launch({ ...config.browser, headless: true });
+            try {
+                browserVersion = browser.version();
+            }
+            finally {
+                await browser.close();
+            }
+        }
+        const installations = await Promise.all(Object.entries(agentDirectories).map(async ([agent, directory]) => ({ agent, directory, installed: await exists(root, `${directory}/design-research/SKILL.md`) })));
+        return { node: process.version, executable, launchVerified: Boolean(args.flags.launch), browserVersion, installations, limits: 'Filesystem checks do not establish agent activation; browser presence alone does not establish launch capability.' };
+    }
+    if (args.command === 'context show')
+        return loadContext(root);
+    if (args.command === 'context validate') {
+        await loadContext(root);
+        return { valid: true, path: contextPath };
+    }
+    if (args.command === 'analyze')
+        return analyzeProject(root);
+    if (args.command === 'validate') {
+        const path = args.positional[0] ?? contextPath;
+        const value = await readJSON(root, path);
+        validate('design-context.schema.json', value);
+        return { valid: true, path };
+    }
+    if (args.command === 'context migrate') {
+        const original = inputPath(args);
+        const destination = flag(args, 'out', '.tevra/migrated-context.json');
+        if (await exists(root, destination))
+            throw new Error('Migration destination exists; choose a fresh --out path');
+        const context = migrateContext(await readJSON(root, original), flag(args, 'owner', 'project-owner'));
+        await writeJSON(root, destination, context);
+        return { destination, context };
+    }
+    if (args.command === 'context update')
+        return updateContext(root, await readJSON(root, inputPath(args)), numeric(args, 'revision'), args.flags['approve-constraints'] === true);
+    if (args.command === 'memory inspect' || args.command === 'memory list')
+        return inspectMemory(root);
+    if (args.command === 'memory reset')
+        return resetMemory(root, args.flags.yes === true);
+    if (args.command === 'memory update') {
+        const entry = await readJSON(root, inputPath(args));
+        const text = JSON.stringify(entry);
+        if (redact(text) !== text)
+            throw new Error('Possible secret in memory; remove it before persistence');
+        return updateMemory(root, entry, numeric(args, 'revision'));
+    }
+    if (args.command === 'tokens generate') {
+        if (!args.flags['new-system'])
+            throw new Error('Foundation creation requires --new-system; inspect the existing system first');
+        const current = await loadContext(root);
+        if (Object.values(current.tokens).some(layer => Object.keys(layer).length > 0))
+            throw new Error('Existing tokens detected; preserve and extend the approved system explicitly');
+        current.tokens = createFoundation(flag(args, 'brand', '#175a44'));
+        return updateContext(root, current, current.revision);
+    }
+    if (args.command === 'tokens export') {
+        const context = await loadContext(root);
+        const output = exportTokens(context.tokens);
+        await writeAtomic(root, '.tevra/exports/tokens.css', output.css);
+        await writeAtomic(root, '.tevra/exports/tailwind.css', output.tailwind);
+        await writeAtomic(root, '.tevra/exports/tokens.json', output.portable);
+        return { files: ['.tevra/exports/tokens.css', '.tevra/exports/tailwind.css', '.tevra/exports/tokens.json'] };
+    }
+    throw new Error(`Unsupported project command: ${args.command}`);
+}
+//# sourceMappingURL=project-commands.js.map

package/dist/packages/cli/src/project-commands.js.map

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

package/dist/packages/cli/src/run-command.d.ts

@@ -0,0 +1,2 @@
+import type { Arguments } from './arguments.js';
+export declare function runCommand(args: Arguments, root: string): Promise<unknown>;

package/dist/packages/cli/src/run-command.js

@@ -0,0 +1,35 @@
+import { runWorkflow } from '../../workflow-engine/src/index.js';
+import { loadConfig } from '../../core/src/config.js';
+import { loadContext } from '../../design-context/src/index.js';
+import { capture } from '../../visual-testing/src/capture.js';
+import { captureChecks } from '../../visual-testing/src/checks.js';
+import { compare } from '../../visual-testing/src/compare.js';
+import { auditPerformance } from '../../performance-qa/src/index.js';
+import { inputPath } from './arguments.js';
+export async function runCommand(args, root) {
+    const config = await loadConfig(root);
+    const revision = (await loadContext(root)).revision;
+    const captureStage = async () => {
+        const manifest = await capture(root, config, 'current', revision, false, args.flags['allow-custom-browser'] === true);
+        const checks = captureChecks(manifest);
+        return { status: checks.some(check => check.status === 'failed') ? 'failed' : checks.some(check => check.status === 'unverified') ? 'blocked' : 'passed', evidence: ['.tevra/artifacts/current/manifest.json'], message: 'Configured matrix capture, browser assertions, runtime, overflow and axe checks. Manual accessibility remains unverified.' };
+    };
+    const adapters = {
+        'browser-testing': captureStage,
+        'responsive-design': captureStage,
+        'accessibility-qa': captureStage,
+        'visual-review': async () => {
+            const captured = await captureStage();
+            if (captured.status !== 'passed')
+                return captured;
+            const result = await compare(root, config);
+            return { status: result.comparisons.every(comparison => comparison.passed) ? 'passed' : 'failed', evidence: ['.tevra/artifacts/current/manifest.json', '.tevra/artifacts/comparison.json'], message: 'Pixel differences are change signals; subjective visual approval remains separate.' };
+        },
+        'performance-qa': async () => {
+            const result = await auditPerformance(root, config, revision, { allowNetwork: args.flags['allow-network'] === true, allowCustomBrowser: args.flags['allow-custom-browser'] === true });
+            return { status: result.checks.every(check => check.status === 'passed') ? 'passed' : 'failed', evidence: [result.report, result.html], message: 'Lighthouse laboratory navigation audit; no real-user INP claim.' };
+        }
+    };
+    return runWorkflow(root, inputPath(args), adapters);
+}
+//# sourceMappingURL=run-command.js.map

package/dist/packages/cli/src/run-command.js.map

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

package/dist/packages/cli/src/visual-commands.d.ts

@@ -0,0 +1,5 @@
+import type { Arguments } from './arguments.js';
+export declare function visualCommand(args: Arguments, root: string): Promise<{
+    result: unknown;
+    failed: boolean;
+}>;

package/dist/packages/cli/src/visual-commands.js

@@ -0,0 +1,73 @@
+import { stat } from 'node:fs/promises';
+import { loadConfig } from '../../core/src/config.js';
+import { loadContext } from '../../design-context/src/index.js';
+import { validate } from '../../design-context/src/validation.js';
+import { isMissing, readJSON, redact, safePath, writeAtomic, writeJSON } from '../../filesystem/src/index.js';
+import { htmlReport } from '../../quality-engine/src/html.js';
+import { evaluateQuality, markdownReport } from '../../quality-engine/src/index.js';
+import { capture, manifestHash, comparisonSettingsHash } from '../../visual-testing/src/capture.js';
+import { compare, validateCaptureAttempt, assertCaptureMatchesConfig } from '../../visual-testing/src/compare.js';
+import { captureChecks } from '../../visual-testing/src/checks.js';
+import { flag } from './arguments.js';
+export async function visualCommand(args, root) {
+    const config = await loadConfig(root);
+    const context = await loadContext(root);
+    if (args.command === 'capture' || args.command === 'a11y' || args.command === 'browser') {
+        const kind = flag(args, 'kind', 'current');
+        if (kind !== 'baseline' && kind !== 'current')
+            throw new Error('Capture kind must be baseline or current');
+        const manifest = await capture(root, config, kind, context.revision, args.flags['approve-baseline'] === true, args.flags['allow-custom-browser'] === true);
+        const checks = captureChecks(manifest);
+        await writeJSON(root, `.tevra/artifacts/${kind}/checks.json`, checks);
+        return { result: { manifest: `.tevra/artifacts/${kind}/manifest.json`, captures: manifest.entries.length, checks }, failed: args.command === 'browser' ? checks.some(check => check.status !== 'passed') : checks.some(check => check.status === 'failed' && check.severity === 'critical') };
+    }
+    if (args.command === 'compare') {
+        const result = await compare(root, config);
+        return { result, failed: result.comparisons.some(comparison => !comparison.passed) };
+    }
+    if (args.command === 'review') {
+        await capture(root, config, 'current', context.revision, false, args.flags['allow-custom-browser'] === true);
+        await compare(root, config);
+    }
+    const manifest = validate('capture-manifest.schema.json', await readJSON(root, '.tevra/artifacts/current/manifest.json'));
+    if (manifest.kind !== 'current')
+        throw new Error('Expected current capture evidence');
+    await validateCaptureAttempt(root, manifest);
+    assertCaptureMatchesConfig(manifest, config);
+    if (manifest.contextRevision !== context.revision)
+        throw new Error('Capture evidence has a stale context revision');
+    const checks = captureChecks(manifest);
+    try {
+        await stat(await safePath(root, '.tevra/artifacts/comparison.json'));
+        const comparison = validate('comparison.schema.json', await readJSON(root, '.tevra/artifacts/comparison.json'));
+        if (comparison.currentManifestHash !== manifestHash(manifest))
+            throw new Error('Comparison is stale; compare the latest capture first');
+        if (comparison.settingsHash !== comparisonSettingsHash(config))
+            throw new Error('Comparison thresholds changed; run compare again');
+        checks.push(...comparison.checks);
+    }
+    catch (error) {
+        if (!isMissing(error))
+            throw error;
+    }
+    if (args.flags.checks) {
+        const supplied = validate('checks.schema.json', await readJSON(root, flag(args, 'checks')));
+        for (const check of supplied) {
+            const previous = checks.findIndex(candidate => candidate.id === check.id && candidate.status === 'unverified');
+            if (previous >= 0)
+                checks.splice(previous, 1);
+            checks.push(check);
+        }
+    }
+    for (const check of checks)
+        for (const evidence of check.evidence)
+            if (!(await stat(await safePath(root, evidence))).isFile())
+                throw new Error(`Evidence must refer to an existing local file: ${evidence}`);
+    const report = evaluateQuality(checks, config, context.revision);
+    const output = flag(args, 'out', '.tevra/reports/quality.md');
+    await writeJSON(root, '.tevra/reports/quality.json', JSON.parse(redact(JSON.stringify(report))));
+    await writeAtomic(root, output, markdownReport(report));
+    await writeAtomic(root, '.tevra/reports/quality.html', htmlReport(report));
+    return { result: { report: output, html: '.tevra/reports/quality.html', status: report.status, score: report.score, blockers: report.blockers, missing: report.missing }, failed: report.status === 'FAIL' };
+}
+//# sourceMappingURL=visual-commands.js.map

package/dist/packages/cli/src/visual-commands.js.map

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

package/dist/packages/cli/src/workflow-commands.d.ts

@@ -0,0 +1,2 @@
+import type { Arguments } from './arguments.js';
+export declare function workflowCommand(args: Arguments, root: string): Promise<unknown>;

package/dist/packages/cli/src/workflow-commands.js

@@ -0,0 +1,73 @@
+import { readdir } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { loadRegistry } from '../../registry/src/index.js';
+import { planWorkflow } from '../../core/src/router.js';
+import { assertHandoff, transitionPlan } from '../../core/src/workflow.js';
+import { loadContext } from '../../design-context/src/index.js';
+import { validate } from '../../design-context/src/validation.js';
+import { isMissing, readJSON, safePath, withLock, writeJSON } from '../../filesystem/src/index.js';
+import { flag, inputPath, numeric } from './arguments.js';
+import { loadConfig } from '../../core/src/config.js';
+function skill(args) {
+    const selected = flag(args, 'skill');
+    if (!/^[a-z][a-z0-9-]{0,63}$/u.test(selected))
+        throw new Error(`Invalid skill: ${selected}`);
+    return selected;
+}
+export async function workflowCommand(args, root) {
+    const context = await loadContext(root);
+    if (args.command === 'plan' || args.command === 'workflow plan') {
+        const configuration = await loadConfig(root);
+        const mode = flag(args, 'mode', 'standard');
+        if (!['quick', 'standard', 'full'].includes(mode))
+            throw new Error('Mode must be quick, standard or full');
+        const plan = planWorkflow(args.positional.join(' '), { mode: mode === 'quick' ? 'quick' : mode === 'full' ? 'full' : 'standard', maxSteps: numeric(args, 'max-steps', 12), maxMinutes: numeric(args, 'max-minutes', 60), maxRefinements: numeric(args, 'max-refinements', configuration.maxRefinements), contextRevision: context.revision, platform: ['react-native', 'expo'].includes(context.project.framework) ? 'native' : 'web', ...(context.project.framework === 'unknown' ? {} : { framework: context.project.framework }) }, await loadRegistry(typeof args.flags.registry === 'string' ? [await safePath(root, args.flags.registry)] : []));
+        const output = flag(args, 'out', `.tevra/plans/${plan.id}.json`);
+        await writeJSON(root, output, plan);
+        return { path: output, plan };
+    }
+    if (args.command === 'workflow status')
+        return validate('plan.schema.json', await readJSON(root, inputPath(args)));
+    if (args.command === 'workflow approve') {
+        if (!args.flags.yes)
+            throw new Error('Approval requires --yes and --by to record the authorized human decision');
+        return withLock(root, '.tevra/workflow.lock', async () => {
+            const path = inputPath(args);
+            const plan = validate('plan.schema.json', await readJSON(root, path));
+            if (plan.contextRevision !== context.revision)
+                throw new Error('Workflow context revision is stale');
+            plan.approvedBy = flag(args, 'by');
+            await writeJSON(root, path, plan);
+            return plan;
+        });
+    }
+    if (args.command.startsWith('workflow ')) {
+        const status = args.command === 'workflow start' ? 'running' : args.command === 'workflow complete' ? 'passed' : 'failed';
+        return transitionPlan(root, inputPath(args), skill(args), status, flag(args, 'evidence', '').split(',').filter(Boolean), context.revision);
+    }
+    if (args.command.startsWith('handoff ')) {
+        const value = await readJSON(root, inputPath(args));
+        return withLock(root, '.tevra/context.lock', () => withLock(root, '.tevra/handoff.lock', async () => {
+            const freshContext = await loadContext(root);
+            const active = [];
+            try {
+                const directory = await safePath(root, '.tevra/handoffs');
+                for (const file of await readdir(directory))
+                    if (file.endsWith('.json'))
+                        active.push(validate('handoff.schema.json', await readJSON(root, `.tevra/handoffs/${file}`)));
+            }
+            catch (error) {
+                if (!isMissing(error))
+                    throw error;
+            }
+            const handoff = assertHandoff(value, freshContext.revision, active);
+            for (const file of [...handoff.files, ...handoff.inputs, ...handoff.outputs, ...handoff.evidence])
+                await safePath(root, file);
+            if (args.command === 'handoff save')
+                await writeJSON(root, `.tevra/handoffs/${handoff.taskId || randomUUID()}.json`, handoff);
+            return handoff;
+        }));
+    }
+    throw new Error(`Unsupported workflow command: ${args.command}`);
+}
+//# sourceMappingURL=workflow-commands.js.map

package/dist/packages/cli/src/workflow-commands.js.map

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

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

@@ -0,0 +1,181 @@
+export declare const skillNames: readonly ["design-research", "design-direction", "design-system", "ui-builder", "ui-redesign", "responsive-design", "interaction-motion", "visual-review", "accessibility-qa", "performance-qa", "browser-testing", "frontend-review"];
+export type SkillName = string;
+export type EvidenceKind = 'deterministic' | 'heuristic' | 'ai' | 'human';
+export type Status = 'pending' | 'running' | 'awaiting-approval' | 'passed' | 'failed' | 'blocked' | 'skipped';
+export interface Evidence {
+    source: string;
+    claim: string;
+    confidence: 'observed' | 'reported' | 'inferred' | 'unknown';
+}
+export interface Decision {
+    id: string;
+    description: string;
+    approved: boolean;
+    owner: string;
+}
+export type TokenMap = Record<string, string>;
+export interface DesignContext {
+    version: '2.0';
+    revision: number;
+    owner: string;
+    project: {
+        name: string;
+        framework: string;
+        styling: string;
+    };
+    design: {
+        variance: number;
+        motionIntensity: number;
+        visualDensity: number;
+        theme: 'light' | 'dark' | 'system';
+        brandPersonality: string[];
+    };
+    tokens: {
+        primitive: TokenMap;
+        semantic: TokenMap;
+        component: TokenMap;
+        themes: Record<string, TokenMap>;
+        responsive: TokenMap;
+    };
+    constraints: {
+        preserveBrand: boolean;
+        preserveFunctionality: boolean;
+        accessibilityTarget: 'WCAG_2_2_AA';
+        approvedScope: string[];
+    };
+    decisions: Decision[];
+    assumptions: string[];
+    evidence: Evidence[];
+    brand?: {
+        name: string;
+        assets: string[];
+        rules: string[];
+    };
+    approvedDirection?: Decision;
+    responsiveRequirements?: string[];
+    knownRegressions?: {
+        id: string;
+        description: string;
+        evidence: string[];
+        status: 'open' | 'resolved';
+    }[];
+    provenance?: {
+        sourceId: string;
+        revision: string;
+        artifact: string;
+    }[];
+}
+export interface Viewport {
+    name: string;
+    width: number;
+    height: number;
+}
+export interface Action {
+    type: 'click' | 'fill' | 'press' | 'check' | 'expect-visible' | 'expect-hidden' | 'expect-text' | 'expect-checked';
+    selector: string;
+    value?: string;
+}
+export interface ScreenState {
+    name: string;
+    actions: Action[];
+    masks: string[];
+    waitFor?: string;
+}
+export interface VisualRoute {
+    name: string;
+    path: string;
+    states: ScreenState[];
+}
+export declare const categories: readonly ["hierarchy", "typography", "layout", "consistency", "responsive", "accessibility", "interaction", "functional", "performance"];
+export type Category = typeof categories[number];
+export interface Config {
+    version: 1;
+    baseURL: string;
+    permittedOrigins: string[];
+    viewports: Viewport[];
+    routes: VisualRoute[];
+    browser: {
+        channel?: string;
+        executablePath?: string;
+    };
+    timeoutMs: number;
+    colorScheme?: 'light' | 'dark' | 'no-preference';
+    reducedMotion?: 'reduce' | 'no-preference';
+    readySelector?: string;
+    thresholds: {
+        diffRatio: number;
+        pixelSensitivity: number;
+        minScore: number;
+    };
+    weights: Record<Exclude<Category, 'functional'>, number> & {
+        functional?: number;
+    };
+    requiredChecks: string[];
+    maxRefinements: number;
+}
+export interface Check {
+    id: string;
+    category: Category;
+    kind: EvidenceKind;
+    status: 'passed' | 'failed' | 'unverified';
+    severity: 'critical' | 'major' | 'minor';
+    score?: number;
+    evidence: string[];
+    issue: string;
+    component: string;
+    correction: string;
+}
+export interface QualityReport {
+    version: 1;
+    createdAt: string;
+    status: 'PASS' | 'FAIL';
+    score: number | null;
+    blockers: string[];
+    missing: string[];
+    checks: Check[];
+    limits: string[];
+    contextRevision: number;
+}
+export interface Handoff {
+    version: 1;
+    taskId: string;
+    objective: string;
+    skill: SkillName;
+    contextVersion: '2.0';
+    contextRevision: number;
+    owner: string;
+    files: string[];
+    inputs: string[];
+    constraints: string[];
+    outputs: string[];
+    acceptance: string[];
+    evidence: string[];
+    status: Status;
+    error: {
+        code: string;
+        message: string;
+    } | null;
+}
+export interface Plan {
+    version: 1;
+    id: string;
+    request: string;
+    mode: 'quick' | 'standard' | 'full';
+    contextVersion: '2.0';
+    contextRevision: number;
+    createdAt: string;
+    budget: {
+        maxSteps: number;
+        maxMinutes: number;
+        maxRefinements: number;
+    };
+    steps: {
+        skill: SkillName;
+        dependsOn: SkillName[];
+        status: Status;
+        attempts: number;
+        evidence: string[];
+    }[];
+    approvalRequired: boolean;
+    approvedBy: string | null;
+}

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

@@ -0,0 +1,3 @@
+export const skillNames = ['design-research', 'design-direction', 'design-system', 'ui-builder', 'ui-redesign', 'responsive-design', 'interaction-motion', 'visual-review', 'accessibility-qa', 'performance-qa', 'browser-testing', 'frontend-review'];
+export const categories = ['hierarchy', 'typography', 'layout', 'consistency', 'responsive', 'accessibility', 'interaction', 'functional', 'performance'];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/contracts/src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,CAAU,CAAC;AAuBjQ,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,CAAU,CAAC"}

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

@@ -0,0 +1,6 @@
+export declare function analyzeProject(root: string): Promise<{
+    framework: string;
+    styling: string[];
+    systemFiles: string[];
+    instructions: string[];
+}>;