@planu/cli 0.15.2

package/dist/tools/data-governance/audit-handler.js

@@ -0,0 +1,161 @@
+// tools/data-governance/audit-handler.ts — privacy-notice and audit subcommands
+import { specStore, knowledgeStore } from '../../storage/index.js';
+import { ti } from '../../i18n/index.js';
+import { detectPIIInSpec, detectLegalFramework, buildDefaultPrivacyConfig, } from '../../engine/pii-detector.js';
+import { readFile } from 'node:fs/promises';
+// ---------------------------------------------------------------------------
+// privacy-notice subcommand
+// ---------------------------------------------------------------------------
+export async function handlePrivacyNotice(projectId) {
+    const specs = await specStore.listSpecs(projectId);
+    const privacyItems = [];
+    for (const spec of specs) {
+        let specText = `${spec.title} ${spec.type}`;
+        try {
+            if (spec.huPath) {
+                specText += ' ' + (await readFile(spec.huPath, 'utf-8'));
+            }
+        }
+        catch {
+            /* file not available */
+        }
+        const result = detectPIIInSpec(spec.title, specText, specText);
+        if (result.hasPII) {
+            privacyItems.push({
+                specId: spec.id,
+                title: spec.title,
+                piiFields: result.fields.map((f) => `${f.fieldName} (${f.category})`),
+                legalBasis: result.recommendedLegalBasis,
+            });
+        }
+    }
+    const notice = buildPrivacyNoticeText(privacyItems);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: ti('tools.data_governance.privacyNoticeSuccess', {
+                    count: String(privacyItems.length),
+                }),
+            },
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    subcommand: 'privacy-notice',
+                    specsWithPII: privacyItems.length,
+                    totalSpecs: specs.length,
+                    noticeText: notice,
+                    disclaimer: 'This is a technical privacy notice draft. Legal review is required before publication.',
+                }, null, 2),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// audit subcommand
+// ---------------------------------------------------------------------------
+export async function handleAudit(projectId) {
+    const specs = await specStore.listSpecs(projectId);
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    const framework = detectLegalFramework({
+        projectPath: knowledge?.projectPath ?? '',
+        existingText: '',
+    });
+    const privacyConfig = buildDefaultPrivacyConfig(framework, []);
+    const auditItems = [];
+    for (const spec of specs) {
+        let specText = `${spec.title} ${spec.type}`;
+        try {
+            if (spec.huPath) {
+                specText += ' ' + (await readFile(spec.huPath, 'utf-8'));
+            }
+        }
+        catch {
+            /* file not available */
+        }
+        const result = detectPIIInSpec(spec.title, specText, specText);
+        const hasPrivacySection = specText.toLowerCase().includes('privacidad y datos') ||
+            specText.toLowerCase().includes('privacy') ||
+            specText.toLowerCase().includes('gdpr');
+        let complianceStatus = 'compliant';
+        if (result.hasPII && !hasPrivacySection) {
+            complianceStatus = 'missing-criteria';
+        }
+        else if (result.hasPII) {
+            complianceStatus = 'needs-review';
+        }
+        auditItems.push({
+            specId: spec.id,
+            title: spec.title,
+            hasPII: result.hasPII,
+            piiFieldCount: result.fields.length,
+            sensitiveSpecialCount: result.sensitiveSpecialCount,
+            challengeRequired: result.hasPII,
+            complianceStatus,
+        });
+    }
+    const nonCompliant = auditItems.filter((i) => i.complianceStatus === 'missing-criteria').length;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: ti('tools.data_governance.auditSuccess', {
+                    total: String(specs.length),
+                    nonCompliant: String(nonCompliant),
+                }),
+            },
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    subcommand: 'audit',
+                    totalSpecs: specs.length,
+                    specsWithPII: auditItems.filter((i) => i.hasPII).length,
+                    nonCompliantSpecs: nonCompliant,
+                    framework,
+                    privacyConfig: {
+                        defaultRetentionDays: privacyConfig.defaultRetentionDays,
+                        auditRetentionDays: privacyConfig.auditRetentionDays,
+                    },
+                    items: auditItems,
+                }, null, 2),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+export function buildPrivacyNoticeText(items) {
+    if (items.length === 0) {
+        return 'No personal data processing detected in current specs.';
+    }
+    const lines = [
+        '# Privacy Notice — Technical Draft',
+        '',
+        '> DISCLAIMER: This is a technical draft generated by Planu.',
+        '> The legal team must review and approve before publication.',
+        '',
+        '## Data We Collect and Process',
+        '',
+    ];
+    for (const item of items) {
+        lines.push(`### ${item.title} (${item.specId})`);
+        lines.push('');
+        lines.push(`**Data collected**: ${item.piiFields.join(', ')}`);
+        lines.push(`**Legal basis**: ${item.legalBasis}`);
+        lines.push('');
+    }
+    lines.push('## Your Rights');
+    lines.push('');
+    lines.push('- Right to access your personal data');
+    lines.push('- Right to rectification of inaccurate data');
+    lines.push('- Right to erasure ("right to be forgotten")');
+    lines.push('- Right to data portability');
+    lines.push('- Right to object to processing');
+    lines.push('');
+    lines.push('## Contact');
+    lines.push('');
+    lines.push('Contact your Data Protection Officer (DPO) for privacy-related requests.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=audit-handler.js.map

package/dist/tools/data-governance/audit-handler.js.map

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

package/dist/tools/data-governance/detect-handler.d.ts

@@ -0,0 +1,6 @@
+import { knowledgeStore } from '../../storage/index.js';
+import type { ToolResult } from '../../types/index.js';
+export declare function handleDetect(specId: string | undefined, projectId: string, inlineContent: string | undefined, projectPath: string): Promise<ToolResult>;
+export declare function handleRetentionPolicy(modelName: string | undefined, projectPath: string): ToolResult;
+export { knowledgeStore };
+//# sourceMappingURL=detect-handler.d.ts.map

package/dist/tools/data-governance/detect-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/data-governance/detect-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,sBAAsB,CAAC;AAa3E,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CA0FrB;AAMD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,MAAM,GAClB,UAAU,CAgDZ;AAGD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/tools/data-governance/detect-handler.js

@@ -0,0 +1,138 @@
+// tools/data-governance/detect-handler.ts — detect and retention-policy subcommands
+import { specStore, knowledgeStore } from '../../storage/index.js';
+import { ti } from '../../i18n/index.js';
+import { detectPIIInSpec, detectLegalFramework, generateRetentionPolicy, generatePrivacySection, } from '../../engine/pii-detector.js';
+import { readFile } from 'node:fs/promises';
+// ---------------------------------------------------------------------------
+// detect subcommand
+// ---------------------------------------------------------------------------
+export async function handleDetect(specId, projectId, inlineContent, projectPath) {
+    // Build title and criteria from specId or inline content
+    if (!specId && !inlineContent) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('errors.invalidInput', {
+                        details: 'Either specId or specContent must be provided for the detect subcommand',
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    let title;
+    let criteria;
+    if (specId) {
+        const spec = await specStore.getSpec(projectId, specId);
+        if (!spec) {
+            return {
+                content: [{ type: 'text', text: ti('spec.notFound', { id: specId }) }],
+                isError: true,
+            };
+        }
+        title = spec.title;
+        criteria = '';
+        if (spec.huPath) {
+            try {
+                criteria = await readFile(spec.huPath, 'utf-8');
+            }
+            catch {
+                /* file not available */
+            }
+        }
+    }
+    else {
+        // inlineContent is guaranteed non-empty here due to the early guard above
+        const content = inlineContent ?? '';
+        const parts = content.split('\n');
+        title = parts[0] ?? '';
+        criteria = content;
+    }
+    const result = detectPIIInSpec(title, criteria, criteria);
+    const framework = detectLegalFramework({ projectPath, existingText: criteria });
+    const retentionPolicy = generateRetentionPolicy(result.fields, framework);
+    const privacySection = generatePrivacySection(result, framework, retentionPolicy);
+    const requirement = {
+        specId: specId ?? 'inline',
+        detectedAt: new Date().toISOString(),
+        piiFields: result.fields,
+        legalBasis: result.recommendedLegalBasis,
+        retentionPolicy,
+        consentRequired: result.requiresConsentFlow,
+        consentGranular: result.requiresConsentFlow,
+        auditTrailRequired: result.requiresAuditTrail,
+        auditRetentionDays: 365,
+        privacyNoticeSection: privacySection.join('\n'),
+        challengeRequired: result.hasPII,
+        challengeCompleted: false,
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: ti('tools.data_governance.detectSuccess', {
+                    count: String(result.fields.length),
+                    hasPII: String(result.hasPII),
+                }),
+            },
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    subcommand: 'detect',
+                    detectionResult: result,
+                    framework,
+                    retentionPolicy,
+                    requirement,
+                    privacySection: privacySection.join('\n'),
+                }, null, 2),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// retention-policy subcommand
+// ---------------------------------------------------------------------------
+export function handleRetentionPolicy(modelName, projectPath) {
+    // When no model name, generate a default policy for a generic user model
+    const effectiveModel = modelName ?? 'User';
+    // Detect framework from project path context
+    const framework = detectLegalFramework({ projectPath });
+    const defaultRetentionPolicy = generateRetentionPolicy([
+        {
+            fieldName: 'example',
+            modelContext: effectiveModel,
+            category: 'personal',
+            isSensitiveSpecial: false,
+            canBeAnonymized: true,
+            canBePseudonymized: true,
+        },
+    ], framework);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: ti('tools.data_governance.retentionSuccess', { model: effectiveModel }),
+            },
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    subcommand: 'retention-policy',
+                    modelName: effectiveModel,
+                    framework,
+                    retentionPolicy: defaultRetentionPolicy,
+                    auditFields: [
+                        'created_at',
+                        'updated_at',
+                        'deleted_at',
+                        'data_owner_id',
+                        'retention_expires_at',
+                    ],
+                }, null, 2),
+            },
+        ],
+    };
+}
+// Re-export for use by the main handler
+export { knowledgeStore };
+//# sourceMappingURL=detect-handler.js.map

package/dist/tools/data-governance/detect-handler.js.map

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

package/dist/tools/data-governance.d.ts

@@ -0,0 +1,3 @@
+import type { DataGovernanceInput, ToolResult } from '../types/index.js';
+export declare function handleDataGovernance(args: DataGovernanceInput): Promise<ToolResult>;
+//# sourceMappingURL=data-governance.d.ts.map

package/dist/tools/data-governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-governance.d.ts","sourceRoot":"","sources":["../../src/tools/data-governance.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQzE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqCzF"}

package/dist/tools/data-governance.js

@@ -0,0 +1,43 @@
+// tools/data-governance.ts — Barrel: Data Governance & Privacy tool handler (SPEC-030)
+// Split into subdirectory for SOLID compliance. Subcommands: detect, retention-policy, privacy-notice, audit.
+import { knowledgeStore } from '../storage/index.js';
+import { ti } from '../i18n/index.js';
+import { handleDetect, handleRetentionPolicy } from './data-governance/detect-handler.js';
+import { handlePrivacyNotice, handleAudit } from './data-governance/audit-handler.js';
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export async function handleDataGovernance(args) {
+    const { specId, projectId, subcommand, modelName, specContent } = args;
+    // Load project knowledge (required for all subcommands)
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [{ type: 'text', text: ti('project.notFound', {}) }],
+            isError: true,
+        };
+    }
+    try {
+        switch (subcommand) {
+            case 'detect':
+                return await handleDetect(specId, projectId, specContent, knowledge.projectPath);
+            case 'retention-policy':
+                return handleRetentionPolicy(modelName, knowledge.projectPath);
+            case 'privacy-notice':
+                return await handlePrivacyNotice(projectId);
+            case 'audit':
+                return await handleAudit(projectId);
+            /* v8 ignore next 2 */
+            default:
+                return await handleDetect(specId, projectId, specContent, knowledge.projectPath);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: ti('errors.internalError', { message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=data-governance.js.map

package/dist/tools/data-governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-governance.js","sourceRoot":"","sources":["../../src/tools/data-governance.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,8GAA8G;AAE9G,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAyB;IAClE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAEvE,wDAAwD;IACxD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,EAAE,CAAC,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC;YACtE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,QAAQ;gBACX,OAAO,MAAM,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;YAEnF,KAAK,kBAAkB;gBACrB,OAAO,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;YAEjE,KAAK,gBAAgB;gBACnB,OAAO,MAAM,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAE9C,KAAK,OAAO;gBACV,OAAO,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;YAEtC,sBAAsB;YACtB;gBACE,OAAO,MAAM,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,EAAE,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/define-ui-contract/a11y-contract.d.ts

@@ -0,0 +1,15 @@
+import type { A11yLevel, A11yContract } from '../../types/index.js';
+/**
+ * Generate an A11y contract for a UI spec.
+ * Detects WCAG level from context (defaults to AA).
+ */
+export declare function generateA11yContract(components: string[], level?: A11yLevel): A11yContract;
+/**
+ * Detects the appropriate WCAG level from project context (spec content or tags).
+ */
+export declare function detectA11yLevel(specContent: string): A11yLevel;
+/**
+ * Format A11y Contract as Markdown.
+ */
+export declare function formatA11yContract(contract: A11yContract): string;
+//# sourceMappingURL=a11y-contract.d.ts.map

package/dist/tools/define-ui-contract/a11y-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-contract.d.ts","sourceRoot":"","sources":["../../../src/tools/define-ui-contract/a11y-contract.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EAGb,MAAM,sBAAsB,CAAC;AAI9B;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,SAAgB,GAAG,YAAY,CAwBhG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAM9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAgDjE"}

package/dist/tools/define-ui-contract/a11y-contract.js

@@ -0,0 +1,199 @@
+// tools/define-ui-contract/a11y-contract.ts — Accessibility Contract (SPEC-017a)
+// Generates WCAG 2.1 AA/AAA contracts per component, ARIA live regions, keyboard patterns.
+// === Public API ===
+/**
+ * Generate an A11y contract for a UI spec.
+ * Detects WCAG level from context (defaults to AA).
+ */
+export function generateA11yContract(components, level = 'AA') {
+    const contrastRatios = buildContrastRatios(level);
+    const componentContracts = buildComponentContracts(components);
+    const ariaLiveRegions = buildAriaLiveRegions(components);
+    const keyboardPatterns = buildKeyboardPatterns(components);
+    const skipNavLink = components.some((c) => c.toLowerCase().includes('nav') ||
+        c.toLowerCase().includes('header') ||
+        c.toLowerCase().includes('menu'));
+    return {
+        level,
+        contrastRatios,
+        componentContracts,
+        ariaLiveRegions,
+        keyboardPatterns,
+        skipNavLink,
+        manualTestingNote: 'Automated axe-core tests detect ~30% of a11y issues. ' +
+            'Remaining 70% requires manual testing with a screen reader ' +
+            '(NVDA + Firefox on Windows, VoiceOver + Safari on macOS/iOS).',
+    };
+}
+/**
+ * Detects the appropriate WCAG level from project context (spec content or tags).
+ */
+export function detectA11yLevel(specContent) {
+    const lower = specContent.toLowerCase();
+    if (lower.includes('wcag aaa') || lower.includes('wcag 2.1 aaa') || lower.includes('aaa')) {
+        return 'AAA';
+    }
+    return 'AA';
+}
+/**
+ * Format A11y Contract as Markdown.
+ */
+export function formatA11yContract(contract) {
+    const lines = [`## Accessibility Contract (WCAG 2.1 ${contract.level})`];
+    lines.push('');
+    lines.push(`**Required level:** WCAG 2.1 ${contract.level} — Normal text contrast: **${contract.contrastRatios.normalText}:1** minimum, Large text: **${contract.contrastRatios.largeText}:1** minimum`);
+    if (contract.skipNavLink) {
+        lines.push('');
+        lines.push('**Skip Navigation:** Include `<a href="#main-content" class="skip-link">Skip to main content</a>` as first focusable element.');
+    }
+    if (contract.componentContracts.length > 0) {
+        lines.push('');
+        lines.push('### Per-Component Requirements');
+        lines.push('');
+        for (const cc of contract.componentContracts) {
+            lines.push(`**${cc.component}:**`);
+            for (const req of cc.requirements) {
+                lines.push(`  - ${req}`);
+            }
+        }
+    }
+    if (contract.ariaLiveRegions.length > 0) {
+        lines.push('');
+        lines.push('### ARIA Live Regions');
+        lines.push('');
+        for (const region of contract.ariaLiveRegions) {
+            lines.push(`- ${region}`);
+        }
+    }
+    if (contract.keyboardPatterns.length > 0) {
+        lines.push('');
+        lines.push('### Keyboard Navigation Patterns');
+        lines.push('');
+        for (const pattern of contract.keyboardPatterns) {
+            lines.push(`- ${pattern}`);
+        }
+    }
+    lines.push('');
+    lines.push(`> **Manual Testing Required:** ${contract.manualTestingNote}`);
+    return lines.join('\n');
+}
+// === Internal helpers ===
+function buildContrastRatios(level) {
+    if (level === 'AAA') {
+        return { level, normalText: 7, largeText: 4.5 };
+    }
+    return { level, normalText: 4.5, largeText: 3 };
+}
+function buildComponentContracts(components) {
+    const contracts = [];
+    for (const component of components) {
+        const lower = component.toLowerCase();
+        const requirements = [];
+        if (lower.includes('modal') || lower.includes('dialog')) {
+            requirements.push('focus trap: focus must stay inside modal while open');
+            requirements.push('Escape key closes the modal and returns focus to trigger element');
+            requirements.push('role="dialog" + aria-labelledby pointing to modal title');
+            requirements.push('aria-modal="true" to prevent screen reader from accessing background');
+        }
+        if (lower.includes('form') || lower.includes('input')) {
+            requirements.push('All inputs associated with labels via htmlFor/id or aria-labelledby');
+            requirements.push('Required fields: aria-required="true" + visual indicator (not color alone)');
+            requirements.push('Validation errors: aria-live="assertive" region + aria-describedby on input');
+            requirements.push('Error messages associated with specific fields via aria-describedby');
+        }
+        if (lower.includes('table') || lower.includes('grid') || lower.includes('list')) {
+            requirements.push('Table: <caption> or aria-label describing table purpose');
+            requirements.push('Column headers: <th scope="col">, row headers: <th scope="row">');
+            requirements.push('Sortable columns: aria-sort="ascending|descending|none"');
+            requirements.push('Keyboard: Tab to navigate, arrow keys within grid cells (if role="grid")');
+        }
+        if (lower.includes('dropdown') ||
+            lower.includes('select') ||
+            lower.includes('menu') ||
+            lower.includes('nav')) {
+            requirements.push('Follow ARIA APG: Listbox, Combobox, or Menu pattern as appropriate');
+            requirements.push('Arrow keys navigate options, Enter selects, Escape closes');
+            requirements.push('Active option highlighted with aria-activedescendant or focus management');
+        }
+        if (lower.includes('button') || lower.includes('action')) {
+            requirements.push('All buttons have accessible names (visible text or aria-label)');
+            requirements.push('Icon-only buttons: aria-label required');
+            requirements.push('Toggle buttons: aria-pressed="true|false"');
+            requirements.push('Loading state: aria-busy="true" + aria-label="Loading..."');
+        }
+        if (lower.includes('toast') || lower.includes('notification') || lower.includes('alert')) {
+            requirements.push('Errors/critical: role="alert" with aria-live="assertive"');
+            requirements.push('Info/success notifications: aria-live="polite"');
+            requirements.push('Dismissible: Escape key or visible close button');
+        }
+        if (requirements.length > 0) {
+            contracts.push({ component, requirements });
+        }
+    }
+    // Always add general requirements if no specific components were matched
+    if (contracts.length === 0) {
+        contracts.push({
+            component: 'All interactive elements',
+            requirements: [
+                'Keyboard accessible: operable via Tab, Enter, Space, Escape as appropriate',
+                'Visible focus indicator on all focusable elements',
+                'Accessible name for all interactive elements (visible text or aria-label)',
+                'Avoid keyboard traps except in intentional modal dialogs',
+            ],
+        });
+    }
+    return contracts;
+}
+function buildAriaLiveRegions(components) {
+    const regions = [];
+    const componentStr = components.join(' ').toLowerCase();
+    if (componentStr.includes('form') || componentStr.includes('input')) {
+        regions.push('Form errors: <div role="alert" aria-live="assertive">{error}</div>');
+    }
+    if (componentStr.includes('toast') ||
+        componentStr.includes('notification') ||
+        componentStr.includes('success')) {
+        regions.push('Notifications/toasts: <div aria-live="polite" aria-atomic="true">{message}</div>');
+    }
+    if (componentStr.includes('load') ||
+        componentStr.includes('fetch') ||
+        componentStr.includes('spinner')) {
+        regions.push('Loading indicators: <div role="status" aria-busy={isLoading} aria-label="Loading content">');
+    }
+    if (componentStr.includes('search') || componentStr.includes('filter')) {
+        regions.push('Search results count: <div aria-live="polite">{count} results found</div>');
+    }
+    if (regions.length === 0) {
+        regions.push('Status messages: aria-live="polite" for non-urgent updates');
+        regions.push('Error alerts: role="alert" for critical issues requiring immediate attention');
+    }
+    return regions;
+}
+function buildKeyboardPatterns(components) {
+    const patterns = [];
+    const componentStr = components.join(' ').toLowerCase();
+    if (componentStr.includes('dropdown') || componentStr.includes('select')) {
+        patterns.push('Listbox/Combobox: Down/Up arrows navigate, Enter selects, Escape closes');
+    }
+    if (componentStr.includes('datepicker') || componentStr.includes('calendar')) {
+        patterns.push('Date picker: Arrow keys navigate dates, Enter selects, Escape closes');
+    }
+    if (componentStr.includes('menu') || componentStr.includes('nav')) {
+        patterns.push('Navigation menu: Tab between top-level items, Enter/Space opens submenu');
+    }
+    if (componentStr.includes('tab')) {
+        patterns.push('Tabs: Arrow keys switch tabs (automatic activation), Tab moves to panel content');
+    }
+    if (componentStr.includes('modal') || componentStr.includes('dialog')) {
+        patterns.push('Dialog: Tab cycles within, Shift+Tab reverses, Escape closes');
+    }
+    if (componentStr.includes('slider') || componentStr.includes('range')) {
+        patterns.push('Slider: Arrow keys adjust value, Home/End go to min/max');
+    }
+    if (patterns.length === 0) {
+        patterns.push('All interactive elements operable via keyboard without requiring mouse');
+        patterns.push('Logical Tab order following visual reading order');
+    }
+    return patterns;
+}
+//# sourceMappingURL=a11y-contract.js.map

package/dist/tools/define-ui-contract/a11y-contract.js.map

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

package/dist/tools/define-ui-contract/agent-interaction-contract.d.ts

@@ -0,0 +1,14 @@
+import type { ProjectKnowledge, Spec } from '../../types/index.js';
+import { isAgentSpec } from '../../engine/agent-spec-generator.js';
+export { isAgentSpec };
+/**
+ * Returns true if the spec/knowledge is for an AI agent project.
+ * Agents need an Interaction Contract instead of a standard UI contract.
+ */
+export declare function isAgentInteractionContract(knowledge: ProjectKnowledge | null, spec?: Spec): boolean;
+/**
+ * Generate the Interaction Contract for an agent spec.
+ * Criteria 3: channels (chat/email/dashboard/notifications), response formats, escalation rules.
+ */
+export declare function generateAgentInteractionContractMarkdown(spec: Spec, knowledge: ProjectKnowledge | null): string;
+//# sourceMappingURL=agent-interaction-contract.d.ts.map

package/dist/tools/define-ui-contract/agent-interaction-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-interaction-contract.d.ts","sourceRoot":"","sources":["../../../src/tools/define-ui-contract/agent-interaction-contract.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAuB,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAGL,WAAW,EACZ,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAClC,IAAI,CAAC,EAAE,IAAI,GACV,OAAO,CAgBT;AAED;;;GAGG;AACH,wBAAgB,wCAAwC,CACtD,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,MAAM,CA+BR"}