@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/types/index.d.ts

@@ -0,0 +1,2187 @@
+/**
+ * NeuraLoom Core Types - Single Source of Truth
+ * All types must be imported from this package across the entire monorepo
+ */
+import { WORKFLOW_STEPS } from '../constants/workflow';
+import type { AgentRole } from '../constants/AGENT_ROLES';
+import type { ReactNode } from 'react';
+export type UserRole = "owner" | "client" | "admin";
+export type Json = string | number | boolean | null | {
+    [key: string]: Json | undefined;
+} | Json[];
+export interface User {
+    id: string;
+    email: string;
+    role: "owner" | "client" | "admin";
+    createdAt: string;
+    updatedAt: string;
+    profile?: UserProfile;
+}
+export interface UserProfile {
+    firstName?: string;
+    lastName?: string;
+    avatar?: string;
+    timezone?: string;
+    preferences: UserPreferences;
+}
+export interface UserPreferences {
+    theme: "light" | "dark" | "system";
+    notifications: NotificationSettings;
+    language: string;
+}
+export interface NotificationSettings {
+    email: boolean;
+    push: boolean;
+    inApp: boolean;
+}
+export interface Notification {
+    id: string;
+    message: string;
+    type: 'info' | 'success' | 'warning' | 'error';
+    projectId?: string;
+    readAt?: string;
+    createdAt: string;
+}
+export interface NotificationDisplay {
+    id: string;
+    title: string;
+    message: string;
+    type: 'info' | 'success' | 'warning' | 'error';
+    read: boolean;
+    createdAt: string;
+    projectId: string;
+    projectTitle: string;
+    url: string;
+}
+export interface NotificationsData {
+    notifications: NotificationDisplay[];
+    unreadCount: number;
+}
+export interface UserSettingsResponse {
+    profile: {
+        firstName?: string;
+        lastName?: string;
+        fullName?: string;
+        avatar?: string;
+        timezone?: string;
+    } | null;
+    settings: {
+        theme: 'light' | 'dark' | 'system';
+        language: string;
+        notifications: NotificationSettings;
+    };
+}
+export interface SimpleSettingsData {
+    settingsLastUpdated: string | null;
+    hasCustomSettings: boolean;
+}
+export interface TestResult {
+    provider: IntegrationProvider;
+    status: 'connected' | 'disconnected' | 'error' | 'timeout';
+    responseTime: number;
+    details?: Record<string, any>;
+    error?: string;
+    timestamp: string;
+}
+export interface GitHubAPICommit {
+    sha: string;
+    commit: {
+        author: {
+            name: string;
+            email: string;
+            date: string;
+        };
+        message: string;
+    };
+    stats?: {
+        additions: number;
+        deletions: number;
+        total: number;
+    };
+    files?: Array<{
+        filename: string;
+        status: string;
+        additions?: number;
+        deletions?: number;
+        changes?: number;
+    }>;
+}
+export interface GitHubAPIPR {
+    id: number;
+    number: number;
+    title: string;
+    body: string | null;
+    state: string;
+    user: {
+        login: string;
+        avatar_url: string;
+    };
+    head: {
+        ref: string;
+        sha: string;
+    };
+    base: {
+        ref: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+    closedAt: string | null;
+    mergedAt: string | null;
+    url: string;
+    htmlUrl: string;
+}
+export interface GitHubAPIIssue {
+    id: number;
+    number: number;
+    title: string;
+    body: string | null;
+    state: string;
+    user: {
+        login: string;
+        avatarUrl: string;
+    };
+    labels: Array<{
+        name: string;
+        color: string;
+    }>;
+    createdAt: string;
+    updatedAt: string;
+    closedAt: string | null;
+    url: string;
+    htmlUrl: string;
+    pullRequest?: any;
+}
+export interface GitHubRepoAPI {
+    id: number;
+    name: string;
+    fullName: string;
+    description: string | null;
+    private: boolean;
+    htmlUrl: string;
+    cloneUrl: string;
+    sshUrl: string;
+    defaultBranch: string;
+    language: string | null;
+    stargazersCount: number;
+    forksCount: number;
+    openIssuesCount: number;
+    createdAt: string;
+    updatedAt: string;
+    pushedAt: string | null;
+    size: number;
+    archived: boolean;
+    disabled: boolean;
+    visibility: string;
+    topics: string[];
+    hasIssues: boolean;
+    hasProjects: boolean;
+    hasWiki: boolean;
+    hasPages: boolean;
+    hasDownloads: boolean;
+    permissions?: {
+        admin: boolean;
+        maintain: boolean;
+        push: boolean;
+        triage: boolean;
+        pull: boolean;
+    };
+    owner: {
+        login: string;
+        avatarUrl: string;
+    };
+}
+export interface SelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface GitHubRepoSelector {
+    id: number;
+    name: string;
+    fullName: string;
+    private: boolean;
+    description: string | null;
+    owner: {
+        login: string;
+        type: 'User' | 'Organization';
+    };
+    url: string;
+}
+/** GET /integrations/github/repos normalized row (NeuraLoom `mapRepo` / link dialog). */
+export type GitHubIntegrationRepoOption = {
+    id: number;
+    name: string;
+    full_name: string;
+    fullName?: string;
+    private: boolean;
+    html_url: string;
+    owner: {
+        login: string;
+        type?: string;
+    };
+    default_branch?: string;
+};
+export interface SettingsData {
+    profile: {
+        id: string;
+        email: string;
+        firstName: string;
+        lastName: string;
+        fullName: string;
+        username: string;
+        avatar: string;
+        website: string;
+        bio: string;
+        location: string;
+        company: string;
+        timezone: string;
+        preferences: {
+            theme: 'light' | 'dark' | 'system';
+            language: string;
+            emailNotifications: boolean;
+            pushNotifications: boolean;
+            marketingEmails: boolean;
+            weeklyDigest: boolean;
+        };
+    };
+    integrations: Array<{
+        id: string;
+        provider: string;
+        status: string;
+        lastSync?: string;
+    }>;
+    security: {
+        twoFactorEnabled: boolean;
+        lastLoginAt: string;
+        loginCount: number;
+        suspiciousActivity: Array<{
+            id: string;
+            type: string;
+            timestamp: string;
+            ipAddress: string;
+        }>;
+    };
+}
+export interface SidebarItem {
+    id: string;
+    label: string;
+    href: string;
+    icon?: string;
+    badge?: string;
+    disabled?: boolean;
+    children?: SidebarItem[];
+}
+export interface ErrorBoundaryState {
+    hasError: boolean;
+    error?: Error;
+}
+export interface ErrorBoundaryProps {
+    children: any;
+    fallback?: any;
+}
+export type Theme = 'light' | 'dark' | 'system';
+export interface ThemeContextType {
+    theme: Theme;
+    setTheme: (theme: Theme) => Promise<void>;
+    resolvedTheme: 'light' | 'dark';
+    isLoading: boolean;
+}
+export interface GeneratedConstitution {
+    id: string;
+    title: string;
+    content: string;
+    version: string;
+    principles: string[];
+    rules: string[];
+    createdAt: string;
+}
+export interface GeneratedSpec {
+    id: string;
+    title: string;
+    description: string;
+    requirements: string[];
+    acceptanceCriteria: string[];
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    status: 'draft' | 'validated' | 'approved' | 'rejected';
+    createdAt: string;
+}
+export interface GeneratedTaskList {
+    tasks: GeneratedTask[];
+    totalTasks: number;
+    estimatedHours: number;
+}
+export interface GeneratedTask {
+    id: string;
+    title: string;
+    description: string;
+    type: 'feature' | 'bug' | 'enhancement' | 'documentation' | 'testing';
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    estimatedHours: number;
+    dependencies: string[];
+    ownerRole?: string;
+    complexity?: 'low' | 'medium' | 'high' | 'very_high';
+    sourceArtifacts?: Array<{
+        type: string;
+        id: string;
+    }>;
+}
+export interface GeneratedCode {
+    id: string;
+    files: CodeFile[];
+    snippets: CodeSnippet[];
+    documentation: string;
+    dependencies: string[];
+    instructions: string;
+    createdAt: string;
+}
+/** Result of opening an implementation PR on a linked repo (ai_runs + git_pull_requests). */
+export type ImplementationPrWriteResult = {
+    prUrl: string;
+    prNumber: number;
+    prBranch: string;
+    baseBranch: string;
+    commitSha: string;
+    /** Present when GitHub writes succeeded but Supabase ai_runs / git_pull_requests updates failed (non-throwing path). */
+    dbSync?: {
+        ok: boolean;
+        error?: string;
+    };
+};
+export interface GeneratedArchitecture {
+    id: string;
+    title: string;
+    description: string;
+    components: ArchitectureComponent[];
+    dataFlow: DataFlowDiagram[];
+    technologies: string[];
+    createdAt: string;
+}
+export interface ArchitectureComponent {
+    name: string;
+    type: 'frontend' | 'backend' | 'database' | 'service' | 'integration';
+    description: string;
+    responsibilities: string[];
+    interfaces: string[];
+}
+export interface DataFlowDiagram {
+    from: string;
+    to: string;
+    data: string;
+    protocol: string;
+}
+export interface CodeFile {
+    path: string;
+    content: string;
+    language: string;
+    description?: string;
+}
+export interface LlmResponse<T> {
+    data: T;
+    metadata: Record<string, any>;
+}
+export interface Project {
+    id: string;
+    title: string;
+    description: string;
+    /** AI-structured brief (populated by "Structure Brief" feature). When present,
+     *  spec/plan/architecture generation uses this instead of the raw description. */
+    briefJson?: import('./ai').ProjectBriefJson | null;
+    status: ProjectStatus;
+    kind: import('../constants/workflow-registry').WorkflowKind;
+    /**
+     * Universal Cognitive Workflow semantic category.
+     * Broader than `kind` — governs gate rubric, artifact taxonomy, and prompt context.
+     * Optional for backward compatibility; defaults to 'software' when absent.
+     */
+    projectKind?: import('./project-kind').ProjectKind;
+    /**
+     * Registry-driven workflow channel selector. Precise execution variant
+     * (e.g. 'fiction_book', 'software_app'). When present takes precedence
+     * over `kind` for orchestrator, display, and completion rule selection.
+     * Backfilled from project_kind by the 20260514200000 migration.
+     * @deprecated Use workflowVariant (camelCase) — case-mapping normalises this on all API responses.
+     */
+    workflow_variant?: string | null;
+    /** Camelcase canonical form of workflow_variant after API case mapping. */
+    workflowVariant?: string | null;
+    ownerId: string;
+    clientId?: string;
+    createdAt: string;
+    updatedAt: string;
+    specs: Spec[];
+    plans: Plan[];
+}
+export interface ProjectSummary {
+    id: string;
+    title: string;
+    description: string;
+    status: ProjectStatus;
+    kind: import('../constants/workflow-registry').WorkflowKind;
+    /** Universal Cognitive Workflow semantic category (optional). */
+    projectKind?: import('./project-kind').ProjectKind;
+    /** Registry-driven workflow execution variant (e.g. 'film_production', 'software_app'). */
+    workflowVariant?: string | null;
+    ownerId: string;
+    clientId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ProjectReport {
+    projectId: string;
+    title: string;
+    description: string;
+    status: ProjectStatus;
+    specs: {
+        title: string;
+        description: string;
+        status: string;
+        priority: string;
+    }[];
+    tasks: {
+        title: string;
+        description: string;
+        status: string;
+        priority: string;
+        estimatedHours: number;
+    }[];
+    summary: {
+        totalSpecs: number;
+        totalTasks: number;
+        completedTasks: number;
+    };
+    generatedAt: string;
+}
+export type ProjectStatus = "draft" | "active" | "completed" | "archived";
+export interface Spec {
+    id: string;
+    projectId: string;
+    title: string;
+    description: string;
+    requirements: string[];
+    acceptanceCriteria: string[];
+    priority: SpecPriority;
+    status: SpecStatus;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    reviewedBy?: string;
+    reviewedAt?: string;
+}
+export type SpecPriority = "low" | "medium" | "high" | "critical";
+export type SpecStatus = "draft" | "validated" | "approved" | "rejected";
+export interface Plan {
+    id: string;
+    projectId: string;
+    specId: string;
+    title: string;
+    description: string;
+    estimatedHours: number;
+    actualHours?: number;
+    status: PlanStatus;
+    tasks: Task[];
+    dependencies: string[];
+    createdAt: string;
+    updatedAt: string;
+    assignedTo?: string;
+}
+export type PlanStatus = "draft" | "approved" | "in_progress" | "completed" | "blocked";
+export interface Task {
+    id: string;
+    planId: string;
+    title: string;
+    description: string;
+    type: TaskType;
+    status: TaskStatus;
+    priority: TaskPriority;
+    estimatedHours: number;
+    actualHours?: number;
+    assignedTo?: string;
+    dependencies: string[];
+    /** Repository-scoped GitHub issue numbers for repair/trace (#417). */
+    linkedGithubIssueNumbers?: number[];
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+export type TaskType = "feature" | "bug" | "enhancement" | "documentation" | "testing";
+export type TaskStatus = "todo" | "in_progress" | "implementing" | "implemented" | "in_review" | "review_failed" | "completed" | "blocked" | "approved" | "ready" | "failed" | "done" | "not_started";
+export type TaskPriority = "low" | "medium" | "high" | "critical";
+export interface ProjectSettings {
+    id: string;
+    projectId: string;
+    githubRepo: string;
+    vercelUrl?: string;
+    dopplerEnv: string;
+    deploymentStatus: "pending" | "deploying" | "deployed" | "failed" | "maintenance";
+    settings: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+/** BMAD-oriented JSONB slice for `project_settings.settings` (GET/PATCH payloads may include additional keys). */
+export type ProjectBmadDeveloperSettingsBlob = {
+    story_artifacts?: {
+        enabled?: boolean;
+        auto_export?: boolean;
+        formats?: string[];
+        store_in_bucket?: boolean;
+    };
+    export_limits?: {
+        max_per_hour?: number;
+        max_size_mb?: number;
+        count_last_hour?: number;
+        total_exports?: number;
+        last_export?: string | null;
+    };
+    nl_kg_v2_enabled?: boolean;
+    storage_usage_mb?: number;
+    workflowExecutionMode?: string;
+    /** When true, cron auto-merges merge-eligible implement PRs for this project. */
+    implementAutoMergeEnabled?: boolean;
+};
+/** Unwrapped `data` from GET /api/projects/[id]/settings (BMAD developer tools slice). */
+export type ProjectBmadSettingsGetResultData = {
+    projectId: string;
+    settings: ProjectBmadDeveloperSettingsBlob;
+    storageUsageMb: number;
+    storageQuotaMb: number;
+};
+/** Unwrapped `data` from PATCH /api/projects/[id]/settings (BMAD + nl_kg_v2_enabled, etc.). */
+export type ProjectBmadSettingsPatchResultData = {
+    settings: ProjectBmadDeveloperSettingsBlob;
+    storageUsageMb: number;
+};
+/** Typed client shape for PATCH /api/projects/[id]/settings success payload. */
+export type ProjectBmadSettingsPatchApiResponse = {
+    success: true;
+    data: ProjectBmadSettingsPatchResultData;
+};
+export type KnowledgeNodeType = "spec" | "task" | "report" | "architecture" | "code" | "constitution" | "plan" | "other" | "patch" | "pr" | "file" | "film_scene" | "film_shot" | "film_prompt" | "film_clip" | "film_export";
+export interface KnowledgeNode {
+    id: string;
+    projectId: string;
+    type: KnowledgeNodeType;
+    content?: string;
+    data?: Record<string, any>;
+    embedding?: number[];
+    createdAt: string;
+}
+export type KnowledgeEdgeRelation = "references" | "fulfills" | "relates" | "SCENE_DERIVED_FROM_SCREENPLAY" | "SHOT_REALIZES_SCENE" | "PROMPT_GENERATED_FROM_SHOT" | "CLIP_REPRESENTS_PROMPT" | "EXPORT_CONTAINS_CLIP" | "ARTIFACT_DERIVED_FROM";
+/** Row shape for `public.knowledge_edges` (see migrations + `KnowledgeEdgeSchema`); `KnowledgeEdgeRelation` is the narrowed relation union for API/join views, not a substitute for this row. */
+export interface KnowledgeEdge {
+    id: string;
+    project_id: string;
+    source_id: string;
+    target_id: string;
+    relation: string;
+    weight?: number | null;
+    metadata?: Record<string, unknown> | null;
+    created_at: string;
+    /** Set by DB after audit migration; absent when inferred only from `KnowledgeEdgeSchema`. */
+    updated_at?: string;
+}
+export interface AuditLog {
+    id: string;
+    projectId?: string;
+    actor: string;
+    action: string;
+    resourceType?: "project" | "spec" | "plan" | "task" | "repo" | "deployment" | "workflow" | "validation" | "user" | "settings";
+    resourceId?: string;
+    details: Record<string, unknown>;
+    ipAddress?: string;
+    userAgent?: string;
+    success: boolean;
+    errorMessage?: string;
+    createdAt: string;
+}
+export interface SystemHealth {
+    status: "healthy" | "degraded" | "down";
+    services: ServiceHealth[];
+    lastChecked: string;
+}
+export interface ServiceHealth {
+    name: string;
+    status: "healthy" | "degraded" | "down";
+    responseTime?: number;
+    lastChecked: string;
+    error?: string;
+}
+export interface HealthStatus {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    timestamp: string;
+    version: string;
+    services: {
+        database: 'up' | 'down' | 'degraded';
+        auth: 'up' | 'down' | 'degraded';
+        api: 'up' | 'down' | 'degraded';
+    };
+    uptime: number;
+    environment: string;
+}
+export type ApiResponse<T = unknown> = {
+    success: true;
+    data: T;
+    timestamp: string;
+} | {
+    success: false;
+    error: ApiError;
+    timestamp: string;
+};
+export interface ApiError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface PaginationParams {
+    page: number;
+    limit: number;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+}
+export interface PaginatedResponse<T> {
+    items: T[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}
+export interface ConstitutionalViolation {
+    id: string;
+    type: ViolationType;
+    severity: "low" | "medium" | "high" | "critical";
+    message: string;
+    file: string;
+    line?: number;
+    rule: string;
+    detectedAt: string;
+    resolvedAt?: string;
+}
+export interface AuthTestConfig {
+    githubUser: string;
+    githubPass: string;
+    githubTotpSecret?: string;
+    baseUrl: string;
+    supabaseUrl: string;
+    supabasePublishableKey: string;
+}
+export interface TestUser {
+    email: string;
+    password: string;
+    fullName: string;
+    accessToken?: string;
+    refreshToken?: string;
+}
+export type ViolationType = "inline_interface" | "hardcoded_css" | "env_fallback" | "missing_validation" | "performance_budget" | "security_violation";
+export interface ComplianceReport {
+    id: string;
+    projectId: string;
+    reportType: "constitutional" | "security" | "performance" | "quality" | "deployment";
+    score: number;
+    passed: boolean;
+    violations: ConstitutionalViolation[];
+    recommendations: string[];
+    metadata: Record<string, unknown>;
+    generatedBy: "github-actions" | "manual" | "scheduled";
+    generatedAt: string;
+    createdAt: string;
+}
+export interface Permission {
+    resource: string;
+    action: 'read' | 'write' | 'delete' | 'admin';
+}
+export interface TeamMember extends User {
+    joinedAt: string;
+}
+export interface TeamMemberSummary {
+    userId: string;
+    role: string;
+    createdAt: string;
+    profile?: {
+        fullName?: string;
+        avatar?: string;
+    } | null;
+}
+export type WorkflowPhaseType = 'governance' | 'design' | 'implementation' | 'delivery';
+export type WorkflowStep = 'constitution' | 'workspace' | 'integrations' | 'specify' | 'plan' | 'schema' | 'api' | 'ui' | 'tasks' | 'implement' | 'repository' | 'ci_cd' | 'deployments' | 'analytics' | 'review' | 'knowledge';
+export interface WorkflowPhase {
+    id: string;
+    title: string;
+    subtitle: string;
+    icon: ReactNode;
+    color: string;
+    bgColor: string;
+    borderColor: string;
+    accentColor: string;
+    steps: Array<{
+        id: string;
+        title: string;
+        description: string;
+        icon: ReactNode;
+        href: string;
+        progress: number;
+        isNew?: boolean;
+    }>;
+}
+export type TeamSpecialization = 'frontend' | 'backend' | 'infra' | 'qa' | 'pm' | 'design' | 'ml';
+export type TeamRole = 'lead' | 'developer' | 'reviewer' | 'agent';
+export type MemberType = 'human' | 'ai';
+export type AIModelProvider = 'openai' | 'anthropic' | 'google' | 'meta' | 'custom';
+export type AIModelRole = 'planner' | 'reviewer' | 'generator' | 'tester' | 'architect' | 'general';
+export interface Team {
+    id: string;
+    projectId: string;
+    name: string;
+    specialization: TeamSpecialization;
+    description?: string;
+    assignedPhases: WorkflowPhaseType[];
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AITeamMember {
+    id: string;
+    teamId: string;
+    userId?: string;
+    memberType: MemberType;
+    role: TeamRole;
+    agentName?: string;
+    agentModel?: string;
+    agentSpecialization?: string;
+    active: boolean;
+    addedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TeamIntegration {
+    id: string;
+    teamId: string;
+    provider: 'github' | 'vercel' | 'supabase' | 'doppler' | 'mcp' | 'playwright';
+    config: Record<string, unknown>;
+    status: 'active' | 'disabled' | 'error';
+    lastSyncedAt?: string;
+    errorMessage?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TeamPhaseAssignment {
+    id: string;
+    projectId: string;
+    teamId: string;
+    phase: WorkflowPhaseType;
+    steps: WorkflowStep[];
+    status: 'active' | 'completed' | 'blocked';
+    progressPercentage: number;
+    assignedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LinkedModel {
+    id: string;
+    teamId: string;
+    modelName: string;
+    provider: AIModelProvider;
+    role: AIModelRole;
+    specialization?: string;
+    specializationContext?: string;
+    temperature: number;
+    maxTokens: number;
+    alwaysInjectFiles: string[];
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentAction {
+    id: string;
+    projectId: string;
+    teamId?: string;
+    agentName: string;
+    actionType: 'code_suggestion' | 'pr_opened' | 'test_generated' | 'spec_reviewed' | 'deployment_monitored' | 'guardian_audit' | 'architecture_generated';
+    description: string;
+    artifacts: AgentArtifact[];
+    approvalStatus: 'pending' | 'approved' | 'rejected' | 'superseded';
+    approvedBy?: string;
+    approvedAt?: string;
+    constitutionalCompliant?: boolean;
+    guardianScore?: number;
+    violations: string[];
+    taskId?: string;
+    specId?: string;
+    prUrl?: string;
+    deploymentId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentActionDisplay {
+    id: string;
+    agentName: string;
+    actionType: string;
+    description: string;
+    guardianScore?: number;
+    violations: string[];
+    approvalStatus: string;
+    createdAt: string;
+}
+export interface AIAgentDisplay {
+    id: string;
+    projectId: string;
+    roleId: string;
+    roleName: string;
+    roleDescription?: string;
+    displayName: string;
+    isActive: boolean;
+    guardianScore: number | null;
+    lastActivity: string | null;
+    config: any;
+    statusMessage?: string;
+    avatar?: string;
+    model?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentArtifact {
+    type: 'file' | 'url' | 'content';
+    name: string;
+    url?: string;
+    content?: string;
+}
+export interface AgentFeedback {
+    id: string;
+    agentId: string;
+    projectId: string;
+    phase?: WorkflowPhaseType;
+    feedback: string;
+    rating?: number;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+export interface OrchestrationStep {
+    id: string;
+    agentId: string;
+    agentRole: string;
+    inputJson: any;
+    order: number;
+}
+export interface Orchestration {
+    id: string;
+    projectId: string;
+    title: string;
+    description?: string;
+    steps: OrchestrationStep[];
+    status: 'draft' | 'queued' | 'running' | 'completed' | 'failed';
+    createdAt: string;
+    updatedAt: string;
+    stepCount?: number;
+}
+export interface OrchestrationExecutionStep {
+    id: string;
+    orchestrationId: string;
+    agentId: string;
+    agentRole: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    inputJson: any;
+    outputJson?: any;
+    errorMessage?: string;
+    startedAt?: string;
+    completedAt?: string;
+    order: number;
+}
+export interface OrchestrationEvent {
+    id: string;
+    orchestrationId: string;
+    stepId: string | null;
+    eventType: 'info' | 'warn' | 'error' | 'success';
+    message: string;
+    data?: any;
+    createdAt: string;
+}
+export interface OrchestrationRun {
+    id: string;
+    projectId: string;
+    title: string;
+    status: 'running' | 'completed' | 'failed' | 'cancelled';
+    steps: OrchestrationExecutionStep[];
+    events: OrchestrationEvent[];
+    startedAt: string;
+    completedAt?: string;
+}
+export interface DashboardStats {
+    totalProjects: number;
+    activeSpecs: number;
+    completedTasks: number;
+    complianceScore: number;
+    recentActivity: ActivityItem[];
+}
+export interface ActivityItem {
+    id: string;
+    type: 'spec_created' | 'plan_approved' | 'task_completed' | 'compliance_check' | 'constitution_created' | 'plan_generated';
+    title: string;
+    description: string;
+    timestamp: string;
+    user: string;
+    projectId?: string;
+}
+export interface TasksPageState {
+    tasks: Task[];
+    loading: boolean;
+    searchQuery: string;
+    statusFilter: TaskStatus | 'all';
+    priorityFilter: TaskPriority | 'all';
+    typeFilter: TaskType | 'all';
+}
+export interface SpecsPageState {
+    specs: Spec[];
+    loading: boolean;
+    searchQuery: string;
+    statusFilter: SpecStatus | 'all';
+    priorityFilter: SpecPriority | 'all';
+}
+export interface SearchResult {
+    id: string;
+    title: string;
+    description: string;
+    type: 'project' | 'spec' | 'task' | 'plan';
+    projectId: string;
+    projectTitle: string;
+    url: string;
+    lastUpdated: string;
+}
+export interface CommandAction {
+    id: string;
+    title: string;
+    description?: string;
+    shortcut?: string;
+    icon?: string | any;
+    action: () => void | Promise<void>;
+    group: 'workflow' | 'governance' | 'navigation' | 'system';
+    permissions?: string[];
+    hidden?: boolean;
+}
+export interface InfraProject {
+    id: string;
+    name: string;
+    brand: string;
+    environment: 'dev' | 'preview' | 'prd';
+    provider: string;
+    status: 'pending' | 'planning' | 'applying' | 'deployed' | 'failed' | 'destroying';
+    created_at: string;
+    updated_at: string;
+    config: Record<string, any>;
+    outputs?: Record<string, any>;
+    last_run_id?: string;
+    created_by?: string;
+}
+export interface InfraRun {
+    id: string;
+    project_id: string;
+    command: 'plan' | 'apply' | 'destroy';
+    status: 'pending' | 'running' | 'success' | 'failed' | 'cancelled';
+    created_at: string;
+    started_at?: string;
+    completed_at?: string;
+    stdout?: string;
+    stderr?: string;
+    exit_code?: number;
+    plan_output?: string;
+    apply_output?: string;
+    guardian_validated?: boolean;
+    guardian_score?: number | null;
+    guardian_violations?: string[];
+    guardian_warnings?: string[];
+    triggered_by?: string;
+}
+export interface InfraGuardianResult {
+    valid: boolean;
+    violations: GuardianViolation[];
+    warnings: GuardianWarning[];
+    score: number;
+    checked_at: string;
+}
+export interface GuardianViolation {
+    rule: string;
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    message: string;
+    resource?: string;
+    suggestion?: string;
+}
+export interface GuardianWarning {
+    rule: string;
+    message: string;
+    resource?: string;
+    suggestion?: string;
+}
+export interface Constitution {
+    id?: string;
+    projectId: string;
+    title: string;
+    content: string;
+    version: string;
+    status: string;
+    principles: string[];
+    rules: string[];
+    validationScore?: number;
+    lastValidatedAt?: string;
+    createdBy?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface SpecFormData {
+    title: string;
+    description: string;
+    requirements: string[];
+    acceptanceCriteria: string[];
+    priority: SpecPriority;
+    status: SpecStatus;
+}
+export interface AnalyticsMetric {
+    label: string;
+    value: string | number;
+    change?: string;
+    trend?: 'up' | 'down' | 'neutral';
+    icon: (props: {
+        className?: string;
+    }) => any;
+}
+export interface TaskStatusData {
+    status: string;
+    count: number;
+    percentage: number;
+    color: string;
+}
+export interface PlanFormData {
+    title: string;
+    description: string;
+    specId: string;
+    estimatedHours: number;
+    actualHours?: number;
+    status: PlanStatus;
+    dependencies: string[];
+    assignedTo?: string;
+}
+export interface GlobalSearchProps {
+    isOpen: boolean;
+    onClose: () => void;
+    /** Pre-fills the search input when the modal opens (e.g. from the Topbar search box). */
+    initialQuery?: string;
+}
+export interface MobileMenuStore {
+    /** Whether the mobile menu is currently open */
+    isOpen: boolean;
+    /** Open the mobile menu */
+    open: () => void;
+    /** Close the mobile menu */
+    close: () => void;
+    /** Toggle the mobile menu open/closed */
+    toggle: () => void;
+}
+export interface WorkflowNavigation {
+    current: typeof WORKFLOW_STEPS[number] | null;
+    prev: typeof WORKFLOW_STEPS[number] | null;
+    next: typeof WORKFLOW_STEPS[number] | null;
+}
+export interface ProjectProgressData {
+    hasConstitution: boolean;
+    specsCount: number;
+    hasArchitecture: boolean;
+    totalTasks: number;
+    completedTasks: number;
+    hasGeneratedCode: boolean;
+    hasComplianceReport: boolean;
+    isArchived: boolean;
+}
+export interface StepProgress {
+    step: number;
+    name: string;
+    percentage: number;
+    isComplete: boolean;
+    description: string;
+}
+export interface ToolResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+    artifacts?: Array<{
+        type: string;
+        name: string;
+        content: string;
+    }>;
+}
+export interface ArchitectureGenerationInput {
+    projectId: string;
+    projectTitle: string;
+    projectDescription: string;
+    specifications: Array<{
+        id: string;
+        title: string;
+        description: string;
+        requirements: string[];
+        acceptanceCriteria: string[];
+    }>;
+    agentRole?: AgentRole;
+}
+export interface DashboardTopbarLink {
+    id: string;
+    label: string;
+    href: string;
+    icon: string;
+    roles?: UserRole[];
+}
+export interface DashboardQuickAction {
+    id: string;
+    label: string;
+    href: string;
+    icon: string;
+    badge?: string;
+    roles?: UserRole[];
+}
+export interface DashboardLayoutConfig {
+    sidebarItems: SidebarItem[];
+    topbarLinks: DashboardTopbarLink[];
+    quickActions: DashboardQuickAction[];
+    showAnalytics: boolean;
+    showAdmin: boolean;
+    topbarTitle: string;
+    showSearch: boolean;
+    showNotifications: boolean;
+    notificationCount: number;
+}
+export interface AuthUser {
+    id: string;
+    email: string;
+    role: string;
+}
+export interface BaseHandlerConfig<TInput = any, TOutput = any> {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    requireAuth?: boolean | undefined;
+    inputSchema?: any;
+    outputSchema?: any;
+    auditAction?: string | undefined;
+    handler: (context: {
+        supabase: any;
+        user: AuthUser | null;
+        input: TInput | undefined;
+        request: any;
+        params: Record<string, string> | undefined;
+        searchParams: URLSearchParams;
+        body?: unknown | undefined;
+    }) => Promise<TOutput>;
+}
+export interface IntegrationWebhookPayload {
+    [key: string]: unknown;
+}
+export interface IntegrationResponse {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+export type IntegrationProvider = "github" | "vercel" | "supabase" | "doppler" | "stripe" | "resend";
+export type IntegrationStatus = "connected" | "disconnected" | "error" | "testing";
+export type IntegrationTier = "tier1" | "tier2" | "tier3";
+export interface IntegrationMetrics {
+    responseTime: number;
+    uptime: number;
+    errorRate: number;
+    requestCount24h: number;
+    avgResponseTime24h: number;
+    lastIncident?: string;
+}
+export interface IntegrationAIInsights {
+    healthScore: number;
+    recommendations: string[];
+    predictedIssues: string[];
+    confidenceLevel: number;
+    lastAnalyzed: string;
+}
+export interface IntegrationHealth {
+    provider: IntegrationProvider;
+    status: IntegrationStatus;
+    lastChecked: string;
+    metrics: IntegrationMetrics;
+    aiInsights?: IntegrationAIInsights;
+}
+export interface IntegrationData {
+    provider: IntegrationProvider;
+    status: IntegrationStatus;
+    displayName: string;
+    description: string;
+    lastChecked: string;
+    metrics?: IntegrationMetrics;
+    aiInsights?: IntegrationAIInsights;
+}
+export interface IntegrationRecord {
+    provider: IntegrationProvider;
+    aiInsights?: IntegrationAIInsights;
+}
+export interface GlobalIntegration {
+    provider: 'github' | 'vercel' | 'supabase' | 'doppler';
+    status: 'connected' | 'disconnected' | 'error' | 'testing';
+    displayName: string;
+    description: string;
+    lastChecked: string;
+    metrics?: {
+        responseTime: number;
+        uptime: number;
+        errorRate: number;
+        requestCount24h: number;
+        avgResponseTime24h: number;
+    };
+}
+export interface GitHubRepo {
+    id: string;
+    projectId: string;
+    userId: string;
+    provider: 'github' | 'gitlab' | 'bitbucket';
+    repoId: string;
+    repoName: string;
+    repoUrl: string;
+    defaultBranch: string;
+    isPrivate: boolean;
+    config: Record<string, unknown>;
+    syncStatus: 'active' | 'paused' | 'error';
+    lastSyncedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface GitHubCommit {
+    id: string;
+    repositoryId: string;
+    taskId?: string;
+    commitSha: string;
+    commitMessage: string;
+    authorName: string;
+    authorEmail: string;
+    authorAvatarUrl?: string;
+    committedAt: string;
+    additions: number;
+    deletions: number;
+    filesChanged: number;
+    branch?: string;
+    url: string;
+    createdAt: string;
+}
+export interface GitHubPullRequest {
+    id: string;
+    repositoryId: string;
+    taskId?: string;
+    prNumber: number;
+    prId: string;
+    title: string;
+    body?: string;
+    state: 'open' | 'closed' | 'merged';
+    authorLogin: string;
+    authorAvatarUrl?: string;
+    headBranch: string;
+    baseBranch: string;
+    headSha?: string;
+    createdAtGithub: string;
+    updatedAtGithub: string;
+    closedAtGithub?: string;
+    mergedAtGithub?: string;
+    url: string;
+    htmlUrl: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface GitHubIssue {
+    id: string;
+    repositoryId: string;
+    taskId?: string;
+    issueNumber: number;
+    issueId: string;
+    title: string;
+    body?: string;
+    state: 'open' | 'closed';
+    authorLogin: string;
+    authorAvatarUrl?: string;
+    labels: string[];
+    createdAtGithub: string;
+    updatedAtGithub: string;
+    closedAtGithub?: string;
+    url: string;
+    htmlUrl: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Deployment {
+    id: string;
+    projectId: string;
+    repositoryId?: string;
+    provider: 'vercel' | 'netlify' | 'aws' | 'gcp' | 'azure' | 'heroku' | 'github-pages';
+    deploymentId: string;
+    deploymentUrl: string;
+    status: 'queued' | 'building' | 'ready' | 'error' | 'cancelled';
+    environment: 'production' | 'preview' | 'development';
+    commitSha?: string;
+    branch?: string;
+    deployedAt: string;
+    readyAt?: string;
+    buildDurationMs?: number;
+    config: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DeploymentLog {
+    id: string;
+    deploymentId: string;
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    source?: 'build' | 'deploy' | 'runtime' | 'system';
+    timestamp: string;
+}
+export type AppTemplateType = 'saas-dashboard' | 'api-backend' | 'e-commerce' | 'ai-chatbot' | 'mobile-pwa' | 'monorepo-fullstack' | 'landing-page' | 'admin-panel';
+export interface AppTemplate {
+    id: string;
+    type: AppTemplateType;
+    name: string;
+    description: string;
+    techStack: TechStackItem[];
+    requiredEnvVars: string[];
+    optionalFeatures: TemplateFeature[];
+    estimatedSetupTime: number;
+    complexity: 'simple' | 'moderate' | 'complex' | 'enterprise';
+    category?: 'web' | 'mobile' | 'backend' | 'fullstack' | 'ai';
+    tags: string[];
+    active: boolean;
+    usageCount: number;
+    successRate?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TechStackItem {
+    name: string;
+    version: string;
+    category: 'frontend' | 'backend' | 'database' | 'infra' | 'tool';
+    required: boolean;
+}
+export interface TemplateFeature {
+    id: string;
+    name: string;
+    description: string;
+    enabled: boolean;
+    configOptions?: Record<string, unknown>;
+}
+export interface BoilerplateConfig {
+    templateType: AppTemplateType;
+    projectName: string;
+    projectDescription: string;
+    features: string[];
+    githubOrg?: string;
+    vercelTeam?: string;
+    dopplerProject?: string;
+    customizations?: Record<string, unknown>;
+}
+export interface BoilerplateArtifact {
+    id: string;
+    projectId: string;
+    templateId: string;
+    config: Record<string, unknown>;
+    files: BoilerplateFile[];
+    migrations: string[];
+    workflows: WorkflowFile[];
+    envVars: EnvVarSpec[];
+    generationMethod: 'llm' | 'template' | 'hybrid';
+    ragSources: string[];
+    validationResults?: ValidationResult;
+    status: 'generating' | 'validating' | 'ready' | 'pushed' | 'failed';
+    errorMessage?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface BoilerplateFile {
+    path: string;
+    content: string;
+    language: string;
+    description?: string;
+    executable?: boolean;
+}
+export interface WorkflowFile {
+    name: string;
+    path: string;
+    content: string;
+    triggers: string[];
+}
+export interface EnvVarSpec {
+    key: string;
+    description: string;
+    required: boolean;
+    defaultValue?: string;
+    secret: boolean;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export type LifecycleStage = 'design' | 'template' | 'generate' | 'validate' | 'repo' | 'push' | 'secrets' | 'deploy' | 'test' | 'complete';
+export interface FactoryLifecycle {
+    id: string;
+    projectId: string;
+    boilerplateId?: string;
+    currentStage: LifecycleStage;
+    completedStages: LifecycleStage[];
+    failedStages: LifecycleStage[];
+    artifacts: LifecycleArtifact[];
+    githubRepoUrl?: string;
+    vercelDeploymentUrl?: string;
+    dopplerProjectName?: string;
+    startedAt: string;
+    completedAt?: string;
+    estimatedCompletion?: string;
+    metadata: Record<string, unknown>;
+}
+export interface LifecycleArtifact {
+    stage: LifecycleStage;
+    type: 'file' | 'url' | 'log' | 'evidence';
+    name: string;
+    content?: string;
+    url?: string;
+    timestamp: string;
+}
+export interface APIRoute {
+    id: string;
+    projectId: string;
+    taskId?: string;
+    specId?: string;
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS';
+    path: string;
+    handlerFilePath?: string;
+    inputSchemaName?: string;
+    outputSchemaName?: string;
+    contractsSchema?: string;
+    handlerCode?: string;
+    deployed: boolean;
+    deploymentId?: string;
+    githubFilePath?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CodeSnippet {
+    id: string;
+    projectId: string;
+    taskId?: string;
+    language: 'typescript' | 'javascript' | 'tsx' | 'jsx' | 'python' | 'sql' | 'yaml' | 'json' | 'markdown' | 'shell';
+    filePath: string;
+    content: string;
+    description?: string;
+    generatedBy: 'ai' | 'user' | 'template' | 'llm';
+    ragContextUsed: boolean;
+    validationPassed?: boolean;
+    validationErrors: string[];
+    constitutionalCompliant?: boolean;
+    guardianScore?: number;
+    createdAt: string;
+}
+export interface ArchitectureGraph {
+    id: string;
+    projectId: string;
+    specIds: string[];
+    graphData: {
+        nodes: ArchitectureNode[];
+        edges: ArchitectureEdge[];
+    };
+    techStack: string[];
+    estimatedWeeks?: number;
+    complexityScore?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ArchitectureNode {
+    id: string;
+    label: string;
+    type: 'api' | 'database' | 'service' | 'integration' | 'frontend' | 'backend';
+    description?: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+}
+export interface ArchitectureEdge {
+    id: string;
+    source: string;
+    target: string;
+    label?: string;
+    type: 'dependency' | 'dataflow' | 'api_call' | 'subscription';
+}
+export interface ProjectRetrospective {
+    id: string;
+    projectId: string;
+    summary: string;
+    achievements: string[];
+    challenges: string[];
+    lessons: string[];
+    metrics: {
+        taskVelocity?: number;
+        specApprovalRate?: number;
+        complianceScore?: number;
+        deploymentSuccessRate?: number;
+        avgBuildTime?: number;
+        totalCommits?: number;
+        totalPRs?: number;
+        totalDeployments?: number;
+    };
+    createdBy?: string;
+    createdAt: string;
+}
+export interface SpecTemplate {
+    id: string;
+    name: string;
+    category: 'api' | 'ui' | 'database' | 'compliance' | 'feature';
+    templateContent: string;
+    fields: Record<string, TemplateField>;
+    usageCount: number;
+    isPublic: boolean;
+    createdAt: string;
+}
+export interface TemplateField {
+    type: 'text' | 'textarea' | 'select' | 'code';
+    required: boolean;
+    placeholder?: string;
+    options?: string[];
+    language?: string;
+}
+export type ComponentCategory = 'data-display' | 'navigation' | 'feedback' | 'data-entry' | 'layout' | 'custom';
+export interface ComponentProp {
+    name: string;
+    type: string;
+    required: boolean;
+    default?: unknown;
+    description?: string;
+}
+export interface UIComponent {
+    id: string;
+    projectId?: string;
+    name: string;
+    displayName: string;
+    category: ComponentCategory;
+    props: ComponentProp[];
+    filePath: string;
+    sourceCode: string;
+    dependencies: string[];
+    tags: string[];
+    description?: string;
+    isPublic: boolean;
+    downloads: number;
+    rating?: number;
+    version: string;
+    createdBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ComponentVersion {
+    id: string;
+    componentId: string;
+    version: string;
+    sourceCode: string;
+    props: ComponentProp[];
+    changelog?: string;
+    createdBy?: string;
+    createdAt: string;
+}
+export interface ComponentAnalytic {
+    id: string;
+    componentId: string;
+    pageId?: string;
+    metricType: 'render_time' | 'usage_count' | 'error_count' | 'accessibility_score';
+    value: number;
+    metadata?: Record<string, unknown>;
+    recordedAt: string;
+}
+export interface ComponentRating {
+    id: string;
+    componentId: string;
+    userId: string;
+    rating: number;
+    review?: string;
+    createdAt: string;
+}
+export interface UIPage {
+    id: string;
+    projectId: string;
+    name: string;
+    slug: string;
+    layout: PageLayout;
+    components: PageComponent[];
+    menuConfig?: MenuConfig;
+    meta?: PageMeta;
+    isProtected: boolean;
+    requiredRoles: string[];
+    filePath: string;
+    createdBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PageLayout {
+    type: 'grid' | 'flex' | 'custom';
+    columns?: number;
+    rows: PageRow[];
+}
+export interface PageRow {
+    id: string;
+    height?: string;
+    columns: PageColumn[];
+}
+export interface PageColumn {
+    id: string;
+    span: number;
+    components: PageComponent[];
+}
+export interface PageComponent {
+    id: string;
+    componentId: string;
+    props: Record<string, unknown>;
+    position: {
+        row: number;
+        col: number;
+    };
+}
+export interface PageVersion {
+    id: string;
+    pageId: string;
+    version: string;
+    layout: PageLayout;
+    components: PageComponent[];
+    changelog?: string;
+    createdBy?: string;
+    createdAt: string;
+}
+export interface MenuConfig {
+    position: number;
+    icon: string;
+    label: string;
+    badge?: string;
+    children?: MenuConfig[];
+}
+export interface PageMeta {
+    title: string;
+    description?: string;
+    openGraph?: {
+        title: string;
+        description: string;
+        image?: string;
+    };
+}
+export interface UITheme {
+    id: string;
+    projectId: string;
+    name: string;
+    tokens: ThemeTokens;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ThemeTokens {
+    colors: Record<string, string>;
+    spacing: Record<string, string>;
+    typography: Record<string, string>;
+    borderRadius: Record<string, string>;
+    shadows: Record<string, string>;
+}
+export * from './project-kind';
+export * from './project-capabilities';
+export * from './pwa';
+export * from './ai-responses';
+export * from './codebase';
+export * from './ai';
+/** Canonical git_repositories linkage + readiness */
+export * from './repo';
+export * from './workflow-graph';
+export * from './graph-canvas';
+export * from './graph-question-mapping';
+export * from './workflow-action-panel';
+export * from './orchestration-execution';
+export * from './resolve-model-policy-input';
+export * from './audiobook';
+export * from './chapter-revision.types';
+export * from './product-readiness';
+export * from './audiobook-embed';
+export interface AuditLogData {
+    projectId?: string;
+    actor: string;
+    action: string;
+    resourceType?: 'project' | 'spec' | 'plan' | 'task' | 'repo' | 'deployment' | 'workflow' | 'validation' | 'user' | 'settings';
+    resourceId?: string;
+    details: Record<string, unknown>;
+    ipAddress?: string;
+    userAgent?: string;
+    success: boolean;
+    errorMessage?: string;
+}
+export interface AuthState {
+    user: User | null;
+    supabaseUser: any | null;
+    loading: boolean;
+    authReady: boolean;
+    error: string | null;
+}
+export interface AuthActions {
+    signInWithGitHub: () => Promise<void>;
+    signInWithPassword: (email: string, password: string) => Promise<void>;
+    signOut: () => Promise<void>;
+    refreshSession: () => Promise<void>;
+    refreshProfile: () => Promise<void>;
+}
+export interface NavigationValidationError extends Error {
+    code: 'CONSTITUTIONAL_VIOLATION';
+    violationType: 'forbidden_route' | 'missing_project_context' | 'ambiguous_scope';
+    currentPath: string;
+    expectedPath?: string;
+}
+export interface ProjectStats {
+    totalProjects: number;
+    activeSpecs: number;
+    completedTasks: number;
+    complianceScore: number;
+    recentActivity: ActivityItem[];
+}
+export interface ProjectReviewMetrics {
+    projectId: string;
+    finalComplianceScore: number;
+    metrics: {
+        plannedHours: number;
+        actualHours: number;
+        tasksCompleted: number;
+        totalTasks: number;
+        specsCreated: number;
+        constitutionsCreated: number;
+        complianceViolations: number;
+        efficiency: number;
+    };
+    completedAt: string;
+    qualityScore: number;
+    teamFeedback: string[];
+    constitutionalCompliance: {
+        score: number;
+        violations: string[];
+        recommendations: string[];
+    };
+}
+export interface ProjectMetrics {
+    id: string;
+    projectId: string;
+    taskVelocity: {
+        completed: number;
+        inProgress: number;
+        avgCompletionTime: number;
+        velocity: number;
+    };
+    specApprovalRate: number;
+    complianceScore: number;
+    codeQuality: {
+        coverage: number;
+        complexity: number;
+        maintainability: number;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AnalyticsMetric {
+    label: string;
+    value: string | number;
+    change?: string;
+    trend?: 'up' | 'down' | 'neutral';
+    icon: (props: {
+        className?: string;
+    }) => any;
+}
+export interface ProjectStatusData {
+    status: string;
+    count: number;
+    percentage: number;
+    color: string;
+}
+export interface TaskStatusData {
+    status: string;
+    count: number;
+    percentage: number;
+    color: string;
+}
+export interface TeamInsights {
+    id: string;
+    projectId: string;
+    userId: string;
+    activityScore: number;
+    tasksCompleted: number;
+    avgResponseTime: number;
+    contributionHistory: ContributionPoint[];
+    workloadBalance: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ContributionPoint {
+    date: string;
+    commits: number;
+    tasksCompleted: number;
+    specsCreated: number;
+    reviewsCompleted: number;
+}
+export interface AnalyticsComplianceReport {
+    id: string;
+    projectId: string;
+    overallScore: number;
+    ssotCompliance: boolean;
+    typeSafety: boolean;
+    performance: boolean;
+    security: boolean;
+    violations: AnalyticsComplianceViolation[];
+    trends: ComplianceTrend[];
+    timestamp: string;
+    generatedBy: string;
+}
+export interface AnalyticsComplianceViolation {
+    id: string;
+    type: 'ssot' | 'type-safety' | 'performance' | 'security' | 'constitutional';
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    message: string;
+    file?: string;
+    line?: number;
+    rule: string;
+    suggestion?: string;
+}
+export interface ComplianceData {
+    overallScore: number;
+    totalProjects: number;
+    compliantProjects: number;
+    violationsCount: number;
+    lastScan: string;
+    projects: Array<{
+        id: string;
+        name: string;
+        score: number;
+        status: 'compliant' | 'warning' | 'critical';
+        violations: Array<{
+            type: string;
+            severity: 'low' | 'medium' | 'high';
+            description: string;
+            file?: string;
+            resolved: boolean;
+        }>;
+        lastScan: string;
+        scanFrequency: string;
+    }>;
+    violations: Array<{
+        id: string;
+        projectId: string;
+        projectName: string;
+        type: string;
+        severity: 'low' | 'medium' | 'high';
+        description: string;
+        file?: string;
+        status: 'open' | 'resolved' | 'acknowledged';
+        createdAt: string;
+        resolvedAt?: string;
+    }>;
+}
+export interface ComplianceTrend {
+    date: string;
+    score: number;
+    violationCount: number;
+    resolved: number;
+    introduced: number;
+}
+export interface NotificationFeed {
+    notifications: Notification[];
+    unreadCount: number;
+    filters: NotificationFilter[];
+    hasMore: boolean;
+    totalCount: number;
+}
+export interface NotificationFilter {
+    id: string;
+    label: string;
+    type: Notification['type'] | 'all';
+    active: boolean;
+}
+export interface AnalyticsDashboardStats {
+    totalProjects: number;
+    activeSpecs: number;
+    completedTasks: number;
+    complianceScore: number;
+    teamMembers: number;
+    recentActivity: DashboardActivityItem[];
+}
+export interface DashboardActivityItem {
+    id: string;
+    type: 'project_created' | 'spec_updated' | 'task_completed' | 'constitution_generated' | 'compliance_check';
+    message: string;
+    userId: string;
+    projectId?: string;
+    timestamp: string;
+    metadata?: Record<string, any>;
+}
+export interface UserSummary {
+    id: string;
+    email: string;
+    role: "owner" | "admin" | "client";
+}
+export interface GuardianViolation {
+    id: string;
+    type: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    message: string;
+    filePath?: string;
+    lineNumber?: number;
+    ruleName?: string;
+    suggestion?: string;
+    category?: 'auth' | 'rls' | 'ssot' | 'performance' | 'security' | 'dependencies';
+    resolved?: boolean;
+    resolvedAt?: string;
+    resolvedBy?: string;
+}
+export interface GuardianComplianceScore {
+    score: number;
+    timestamp: string;
+    breakdown: {
+        ssot: number;
+        typeSafety: number;
+        performance: number;
+        security: number;
+    };
+}
+export type GuardianPhase = 'discover' | 'design' | 'develop' | 'validate' | 'ship' | 'monitor';
+export interface GuardianReport {
+    id: string;
+    projectId: string;
+    phase: GuardianPhase;
+    constitutionVersion: number;
+    score: number;
+    violationsCount: number;
+    passedChecks: string[];
+    failedChecks: string[];
+    validated: boolean;
+    generatedAt: string;
+    metadata?: Record<string, unknown>;
+}
+export interface GuardianValidationRequest {
+    projectId: string;
+    phase?: GuardianPhase;
+    constitutionVersion?: number;
+    autoResolve?: boolean;
+}
+export interface GuardianValidationResult {
+    reportId: string;
+    score: number;
+    severity: 'info' | 'warning' | 'error' | 'critical';
+    phase: GuardianPhase;
+    violationsCount: number;
+    passedChecks: number;
+    violations: GuardianViolation[];
+    validated: boolean;
+    timestamp: string;
+}
+export interface AnalyticsUpdate {
+    type: 'compliance_score' | 'violation_detected' | 'violation_resolved' | 'team_activity' | 'git_commit';
+    projectId: string;
+    data: unknown;
+    timestamp: string;
+}
+export interface AIRecommendation {
+    id: string;
+    type: 'spec' | 'task' | 'architecture' | 'component' | 'schema' | 'api_route';
+    confidence: number;
+    suggestion: string;
+    rationale: string;
+    agentName: string;
+    metadata?: Record<string, any>;
+    createdAt: string;
+}
+export interface AIGenerationResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+    agentName?: string;
+    processingTime?: number;
+    guardianScore?: number;
+    violations?: string[];
+}
+export interface ProjectPageLayoutProps {
+    children: ReactNode;
+    title: string;
+    description?: string;
+    icon?: ReactNode;
+    projectId: string;
+    backHref?: string;
+    backLabel?: string;
+    nextHref?: string;
+    nextLabel?: string;
+    showDashboardLink?: boolean;
+    topActions?: ReactNode;
+    bottomActions?: ReactNode;
+    className?: string;
+    contentClassName?: string;
+    maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
+}
+export interface ProjectProgressNavProps {
+    projectId: string;
+    currentStepId?: string;
+}
+export interface TeamDetailPanelProps {
+    teamId: string;
+    projectId: string;
+}
+export interface UseProjectProgressResult {
+    progressData: ProjectProgressData | null;
+    /** N-007 step id → complete (from resolveStepCompletionMap) */
+    stepCompletion: Record<string, boolean> | null;
+    steps: StepProgress[];
+    overallProgress: number;
+    currentStep: number;
+    getStep: (stepNumber: number) => StepProgress;
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+}
+export interface InfraSpec {
+    provider: string;
+    resources: any[];
+}
+export interface GitHubProfile {
+    full_name?: string;
+    username?: string;
+    avatar_url?: string;
+}
+export interface AILayoutProps {
+    children: ReactNode;
+    currentRole?: AgentRole;
+}
+export interface AuthGuardProps {
+    children: ReactNode;
+    requiredPermissions?: Permission[];
+    fallback?: ReactNode;
+    allowOpenMode?: boolean;
+}
+export interface IntegrationHealth {
+    github: {
+        status: 'healthy' | 'degraded' | 'down';
+        responseTime: number;
+        lastCheck: string;
+        connectedRepos: number;
+        totalRepos: number;
+        webhookStatus: 'active' | 'inactive' | 'error';
+    };
+    vercel: {
+        status: 'healthy' | 'degraded' | 'down';
+        responseTime: number;
+        lastCheck: string;
+        deployments: number;
+        projects: number;
+        latestDeployment?: {
+            id: string;
+            status: string;
+            createdAt: string;
+        };
+    };
+    supabase: {
+        status: 'healthy' | 'degraded' | 'down';
+        responseTime: number;
+        lastCheck: string;
+        databaseSize: string;
+        activeConnections: number;
+        queryPerformance: number;
+    };
+    overall: {
+        uptime: number;
+        avgResponseTime: number;
+        totalIncidents: number;
+        lastIncident?: string;
+    };
+}
+export interface AnalyticsData {
+    aiUsage: {
+        totalRequests: number;
+        successRate: number;
+        avgResponseTime: number;
+        topEndpoints: Array<{
+            endpoint: string;
+            requests: number;
+            avgTime: number;
+        }>;
+        dailyUsage: Array<{
+            date: string;
+            requests: number;
+            errors: number;
+        }>;
+    };
+    guardianScores: {
+        averageScore: number;
+        totalScans: number;
+        violations: number;
+        complianceRate: number;
+        projectScores: Array<{
+            projectId: string;
+            projectName: string;
+            score: number;
+            lastScan: string;
+        }>;
+    };
+    buildHealth: {
+        totalBuilds: number;
+        successRate: number;
+        avgBuildTime: number;
+        recentBuilds: Array<{
+            id: string;
+            status: string;
+            duration: number;
+            timestamp: string;
+        }>;
+    };
+    systemHealth: {
+        uptime: number;
+        memoryUsage: number;
+        cpuUsage: number;
+        activeUsers: number;
+    };
+}
+export interface AgentContext {
+    projectId: string;
+    spec?: any;
+    task?: any;
+    constitution?: string;
+    previousActions?: any[];
+    linkedModels?: any[];
+}
+export interface AgentOutput {
+    result: string;
+    artifacts?: Array<{
+        type: string;
+        name: string;
+        content: string;
+    }>;
+    tokensUsed?: number;
+    modelUsed?: string;
+    attemptCount?: number;
+}
+export interface TabsContextValue {
+    value: string;
+    onValueChange: (value: string) => void;
+}
+export interface TabsProps {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    className?: string;
+    children: ReactNode;
+}
+export interface TabsListProps {
+    className?: string;
+    children: ReactNode;
+}
+export interface TabsTriggerProps {
+    value: string;
+    className?: string;
+    children: ReactNode;
+    disabled?: boolean;
+}
+export interface TabsContentProps {
+    value: string;
+    className?: string;
+    children: ReactNode;
+}
+export type { ConsoleEntryLevel, ConsoleEntry, WorkflowSidebarNavProps, WorkflowFooterNavProps, ProjectWorkflowHubUiPhase, ProjectWorkflowHubPageContract, ProjectCommandCenterHeaderProps, WorkflowNextStepBarProps, } from './workflow-command-center';
+export type { StageCompletionResult, StageRegistryCompletionBlocker, StageRegistryCompletionBlockerCode, StepCompletionResult, WorkflowStepCompletionReason, } from './workflow-completion';
+export type { CiApplyPostSuccess, CiIngestPostSuccess, CiCdStatus, CiPrClassification, CiPrSupersededEvidence, CiRun, CiRunsListResponse, CiStatusGet, CiStatusPerPrEntry, CiStatusResponse, CiStatusState, PrCheckRun, } from './ci';
+export type { AIManuscriptChecksInput, ManuscriptChecksCheckType, ManuscriptChecksIssue, ManuscriptChecksPostResponse, ManuscriptChecksReport, ManuscriptChecksSliceResult, } from './manuscript-checks';
+export * from './community-stage';
+export * from './community-operator-role';
+export * from './community-membership-tier';