@schemyx/mcp 0.1.0 → 0.1.2

package/dist/codebase-scanner/types.d.ts

@@ -0,0 +1,743 @@
+import type { bundleSchemaVersion, graphSchemaVersion, indexSchemaVersion, recipeGroups, recipeSchemaVersion } from './constants';
+export type CodebaseProjectType = 'frontend' | 'backend' | 'full' | 'custom';
+export type RecipeGroup = (typeof recipeGroups)[number];
+export type RecipeStatus = 'approved' | 'inferred' | 'needs_review' | 'stale';
+export type Confidence = 'high' | 'medium' | 'low' | 'inferred';
+export type ContextDepth = 'brief' | 'standard' | 'deep';
+export type PatternReuseDecision = 'prefer' | 'allow' | 'avoid' | 'review';
+export interface PatternScores {
+    appearances: number;
+    files: number;
+    routes: number;
+    owners: string[];
+    structuralSimilarity: number;
+    styleSimilarity: number;
+    behaviorSimilarity: number;
+    canonical: number;
+    oneOffRisk: number;
+}
+export interface PatternDecision {
+    reuse: PatternReuseDecision;
+    scope: string;
+    reason: string;
+}
+export interface ScanArgs {
+    projectType?: unknown;
+    rootPath?: unknown;
+    includePaths?: unknown;
+    excludePaths?: unknown;
+    outputDir?: unknown;
+    maxFiles?: unknown;
+    dryRun?: unknown;
+}
+export interface ListArgs {
+    rootPath?: unknown;
+    outputDir?: unknown;
+    query?: unknown;
+    group?: unknown;
+    limit?: unknown;
+    cursor?: unknown;
+    depth?: unknown;
+}
+export interface SearchArgs extends ListArgs {
+    key?: unknown;
+    kind?: unknown;
+    status?: unknown;
+    confidence?: unknown;
+}
+export interface GetArgs {
+    rootPath?: unknown;
+    outputDir?: unknown;
+    key?: unknown;
+    includeDeps?: unknown;
+    includeUsedBy?: unknown;
+    maxRelated?: unknown;
+    depth?: unknown;
+}
+export interface ContextPackArgs {
+    rootPath?: unknown;
+    outputDir?: unknown;
+    key?: unknown;
+    task?: unknown;
+    depth?: unknown;
+    maxItems?: unknown;
+    tokenBudget?: unknown;
+    includeSource?: unknown;
+}
+export interface GraphArgs {
+    rootPath?: unknown;
+    outputDir?: unknown;
+    key?: unknown;
+    kinds?: unknown;
+    edgeTypes?: unknown;
+    direction?: unknown;
+    radius?: unknown;
+    limitNodes?: unknown;
+    limitEdges?: unknown;
+    cursor?: unknown;
+}
+export interface ReviewArgs {
+    rootPath?: unknown;
+    outputDir?: unknown;
+    status?: unknown;
+    type?: unknown;
+    group?: unknown;
+    limit?: unknown;
+    cursor?: unknown;
+}
+export interface FreshnessArgs {
+    rootPath?: unknown;
+    outputDir?: unknown;
+    keys?: unknown;
+    includeChangedFiles?: unknown;
+    limit?: unknown;
+}
+export interface ReadFileArgs {
+    rootPath?: unknown;
+    outputDir?: unknown;
+    key?: unknown;
+    path?: unknown;
+    maxBytes?: unknown;
+}
+export interface AnalyzedFile {
+    relPath: string;
+    key: string;
+    kind: string;
+    layer: string;
+    language: string;
+    size: number;
+    imports: string[];
+    exports: string[];
+    symbols: string[];
+    functions: string[];
+    classes: string[];
+    types: string[];
+    constants: string[];
+    components: string[];
+    componentProps: Record<string, string[]>;
+    hooks: string[];
+    routes: string[];
+    apiHandlers: string[];
+    controllers: string[];
+    services: string[];
+    modules: string[];
+    models: string[];
+    modelFields: Record<string, string[]>;
+    databaseModels: DatabaseModelContract[];
+    databaseEnums: DatabaseEnumContract[];
+    databaseMigrations: DatabaseMigrationContract[];
+    databaseAccesses: DatabaseAccessContract[];
+    cssVariables: string[];
+    cssVariableValues: CssVariableValue[];
+    cssRules: CssRuleDetail[];
+    cssClasses: string[];
+    classReferences: string[];
+    classExpressions: ClassExpression[];
+    cssIds: string[];
+    cssVariableReferences: string[];
+    tailwindUtilities: string[];
+    componentStyleDefinitions: ComponentStyleDefinition[];
+    themeTokens: ThemeToken[];
+    inlineStyles: InlineStyle[];
+    dependencies: string[];
+    jsxElements: string[];
+    uiElements: UiElement[];
+    apiCalls: string[];
+    envVars: string[];
+    tests: string[];
+    docsHeadings: string[];
+    configKeys: string[];
+    templateIncludes: string[];
+    authHints: string[];
+    middleware: string[];
+    jobs: string[];
+    events: string[];
+    backendEndpointContracts: BackendEndpointContract[];
+    backendOperations: BackendOperationContract[];
+    backendSideEffects: BackendSideEffect[];
+    backendErrors: BackendErrorContract[];
+    backendLogging: BackendLoggingContract[];
+    sourceHash: string;
+    summary: string;
+    tags: string[];
+}
+export type DatabaseProvider = 'prisma' | 'sql' | 'drizzle' | 'typeorm' | 'sequelize' | 'mongoose' | 'django' | 'rails' | 'laravel' | 'generic-orm';
+export type DatabaseModelKind = 'model' | 'table' | 'collection';
+export type DatabaseAccessOperation = 'read' | 'create' | 'update' | 'delete' | 'upsert' | 'write' | 'aggregate' | 'transaction' | 'raw-sql' | 'unknown';
+export interface DatabaseFieldContract {
+    name: string;
+    type?: string;
+    databaseName?: string;
+    required?: boolean;
+    optional?: boolean;
+    list?: boolean;
+    id?: boolean;
+    unique?: boolean;
+    indexed?: boolean;
+    generated?: boolean;
+    updatedAt?: boolean;
+    default?: string;
+    enumName?: string;
+    nativeType?: string;
+    relation?: {
+        model?: string;
+        name?: string;
+        fields: string[];
+        references: string[];
+        onDelete?: string;
+        onUpdate?: string;
+    };
+    line: number;
+    source: DatabaseProvider;
+    raw?: string;
+}
+export interface DatabaseIndexContract {
+    kind: 'primary' | 'unique' | 'index' | 'foreign';
+    name?: string;
+    fields: string[];
+    references?: {
+        table: string;
+        fields: string[];
+    };
+    line: number;
+}
+export interface DatabaseRelationContract {
+    fromModel: string;
+    fromFields: string[];
+    toModel: string;
+    toFields: string[];
+    name?: string;
+    onDelete?: string;
+    onUpdate?: string;
+    line: number;
+    confidence: Confidence;
+}
+export interface DatabaseModelContract {
+    name: string;
+    tableName?: string;
+    kind: DatabaseModelKind;
+    provider: DatabaseProvider;
+    framework?: string;
+    fields: DatabaseFieldContract[];
+    fieldNames: string[];
+    primaryKey: string[];
+    uniqueFields: string[][];
+    indexes: DatabaseIndexContract[];
+    relations: DatabaseRelationContract[];
+    enumRefs: string[];
+    map?: string;
+    line: number;
+    confidence: Confidence;
+    sourcePath: string;
+}
+export interface DatabaseEnumContract {
+    name: string;
+    values: string[];
+    provider: DatabaseProvider;
+    map?: string;
+    line: number;
+    confidence: Confidence;
+    sourcePath: string;
+}
+export interface DatabaseMigrationOperation {
+    kind: 'create-table' | 'alter-table' | 'drop-table' | 'create-index' | 'drop-index' | 'create-enum' | 'drop-enum' | 'insert-seed' | 'update-data' | 'delete-data' | 'raw-sql' | 'unknown';
+    target?: string;
+    fields?: string[];
+    columns?: string[];
+    references?: {
+        table: string;
+        columns: string[];
+    };
+    name?: string;
+    destructive?: boolean;
+    line: number;
+    statement?: string;
+}
+export interface DatabaseMigrationContract {
+    name: string;
+    path: string;
+    provider: DatabaseProvider;
+    operations: DatabaseMigrationOperation[];
+    creates: string[];
+    alters: string[];
+    drops: string[];
+    indexes: string[];
+    enums: string[];
+    seedLike: boolean;
+    destructive: boolean;
+    confidence: Confidence;
+}
+export interface DatabaseAccessContract {
+    operation: DatabaseAccessOperation;
+    model?: string;
+    table?: string;
+    receiver?: string;
+    method?: string;
+    framework: DatabaseProvider;
+    line: number;
+    fields: string[];
+    whereFields: string[];
+    relationHints: string[];
+    transactional?: boolean;
+    raw?: boolean;
+    confidence: Confidence;
+    risk: string[];
+}
+export interface BackendEndpointParam {
+    name: string;
+    source: 'body' | 'query' | 'path' | 'request' | 'response' | 'current-user' | 'unknown';
+    type?: string;
+    required?: boolean;
+    decorator?: string;
+}
+export interface BackendAuthPolicy {
+    required: boolean;
+    public: boolean;
+    guards: string[];
+    roles: string[];
+    permissions: string[];
+    hints: string[];
+    confidence: Confidence;
+}
+export interface BackendValidationContract {
+    bodyType?: string;
+    queryType?: string;
+    pathParams: BackendEndpointParam[];
+    decorators: string[];
+    confidence: Confidence;
+}
+export interface BackendServiceCall {
+    receiver: string;
+    method: string;
+    await: boolean;
+    line: number;
+    kind: 'service' | 'repository' | 'client' | 'provider' | 'unknown';
+}
+export interface BackendSideEffect {
+    kind: 'database-write' | 'email' | 'queue' | 'event' | 'cookie' | 'header' | 'external-api' | 'file' | 'cache' | 'unknown';
+    target?: string;
+    operation?: string;
+    line: number;
+    confidence: Confidence;
+}
+export interface BackendErrorContract {
+    kind: string;
+    message?: string;
+    statusCode?: number;
+    line: number;
+}
+export interface BackendLoggingContract {
+    level: 'log' | 'warn' | 'error' | 'debug' | 'verbose';
+    message?: string;
+    line: number;
+}
+export interface BackendEndpointContract {
+    framework: string;
+    method: string;
+    path: string;
+    fullPath?: string;
+    handler: string;
+    handlerName?: string;
+    controller?: string;
+    line: number;
+    decorators: string[];
+    params: BackendEndpointParam[];
+    request: {
+        bodyType?: string;
+        queryType?: string;
+        pathParams: BackendEndpointParam[];
+        usesRequest: boolean;
+        usesResponse: boolean;
+    };
+    response: {
+        type?: string;
+        statusCodes: number[];
+        returns: string[];
+    };
+    auth: BackendAuthPolicy;
+    validation: BackendValidationContract;
+    serviceCalls: BackendServiceCall[];
+    repositoryCalls: BackendServiceCall[];
+    sideEffects: BackendSideEffect[];
+    errors: BackendErrorContract[];
+    logging: BackendLoggingContract[];
+    risk: string[];
+}
+export interface BackendOperationContract {
+    framework: string;
+    owner: string;
+    ownerKind: 'controller' | 'service' | 'module' | 'unknown';
+    name: string;
+    signature: string;
+    line: number;
+    params: BackendEndpointParam[];
+    returnType?: string;
+    serviceCalls: BackendServiceCall[];
+    repositoryCalls: BackendServiceCall[];
+    sideEffects: BackendSideEffect[];
+    errors: BackendErrorContract[];
+    logging: BackendLoggingContract[];
+    risk: string[];
+}
+export interface UiLayoutSafety {
+    wrapClasses: string[];
+    overflowClasses: string[];
+    minSizeClasses: string[];
+    maxSizeClasses: string[];
+    fitClasses: string[];
+    flexBehaviorClasses: string[];
+    layoutSafetyClasses: string[];
+}
+export interface UiResponsiveProfile {
+    breakpoints: Record<string, string[]>;
+    layoutClasses: string[];
+    typographyClasses: string[];
+    spacingClasses: string[];
+    sizingClasses: string[];
+    visibilityClasses: string[];
+    stateClasses: string[];
+}
+export interface UiScaleProfile {
+    typographyClasses: string[];
+    spacingClasses: string[];
+    sizingClasses: string[];
+    gapClasses: string[];
+    maxWidthClasses: string[];
+    lineHeightClasses: string[];
+}
+export interface UiSemanticProfile {
+    roles: string[];
+    isCompound: boolean;
+    hasIcon: boolean;
+    hasDivider: boolean;
+    hasImage: boolean;
+    hasMultipleTextStyles: boolean;
+    textStyleCount: number;
+    childCount: number;
+}
+export interface UiRoleSignature {
+    role: string;
+    roleGroup: string;
+    scale: string;
+    density: string;
+    surface: string;
+    layout: string;
+    flags: string[];
+    exactClassFacts: string[];
+    childRoles?: string[];
+    childKinds?: string[];
+}
+export interface UiContract {
+    identity: Record<string, unknown>;
+    semantics: Record<string, unknown>;
+    visual: Record<string, unknown>;
+    layout: Record<string, unknown>;
+    responsiveVariants: Record<string, unknown>;
+    interactionVariants: Record<string, unknown>;
+    safetyRules: Record<string, unknown>;
+    sourceEvidence: Record<string, unknown>;
+}
+export interface UiRelationships {
+    parentContext?: unknown;
+    childStructureContract?: unknown;
+    compoundStructure?: unknown;
+    graphKeys: string[];
+}
+export interface UiElement {
+    index: number;
+    kind: string;
+    tag: string;
+    originalTag: string;
+    line: number;
+    depth?: number;
+    parentIndex?: number;
+    parentKind?: string;
+    parentTag?: string;
+    parentClasses?: string[];
+    parentClassGroups?: Record<string, string[]>;
+    layoutRole?: string;
+    label?: string;
+    classes: string[];
+    defaultClasses?: string[];
+    conditionalClasses?: string[];
+    decorativeAccentClasses?: string[];
+    classSource?: string;
+    classGroups?: Record<string, string[]>;
+    responsiveClasses?: string[];
+    stateClasses?: string[];
+    layoutSafety?: UiLayoutSafety;
+    responsiveProfile?: UiResponsiveProfile;
+    scaleProfile?: UiScaleProfile;
+    semanticProfile?: UiSemanticProfile;
+    roleSignature?: UiRoleSignature;
+    childSummary?: UiElementChildSummary[];
+    id?: string;
+    role?: string;
+    type?: string;
+    href?: string;
+    action?: string;
+    method?: string;
+    props?: Record<string, string>;
+    variants?: Record<string, string>;
+    styleHelper?: string;
+    styleHelperVariants?: Record<string, string>;
+    evidence: string;
+}
+export interface UiElementChildSummary {
+    index: number;
+    kind: string;
+    tag: string;
+    originalTag: string;
+    layoutRole?: string;
+    classes: string[];
+    defaultClasses?: string[];
+    conditionalClasses?: string[];
+    layoutSafety?: UiLayoutSafety;
+    responsiveProfile?: UiResponsiveProfile;
+    scaleProfile?: UiScaleProfile;
+    semanticRole?: string;
+    semanticProfile?: UiSemanticProfile;
+    roleSignature?: UiRoleSignature;
+    props?: Record<string, string>;
+    variants?: Record<string, string>;
+    styleHelper?: string;
+    styleHelperVariants?: Record<string, string>;
+    label?: string;
+}
+export interface ConnectedPatternEvidence {
+    path: string;
+    line?: number;
+    component?: string;
+    route?: string;
+    key?: string;
+    label?: string;
+    sourceHash: string;
+}
+export interface ConnectedPatternInstance {
+    domain: 'frontend' | 'backend' | 'data';
+    concept: string;
+    signature: string;
+    summary: string;
+    file: AnalyzedFile;
+    root?: {
+        kind?: string;
+        tag?: string;
+        layoutRole?: string;
+        classes?: string[];
+        defaultClasses?: string[];
+        conditionalClasses?: string[];
+        decorativeAccentClasses?: string[];
+        classGroups?: Record<string, string[]>;
+        layoutSafety?: UiLayoutSafety;
+        responsiveProfile?: UiResponsiveProfile;
+        scaleProfile?: UiScaleProfile;
+        semanticProfile?: UiSemanticProfile;
+        roleSignature?: UiRoleSignature;
+        uiContract?: UiContract;
+    };
+    children?: Array<Record<string, unknown>>;
+    graphKeys: string[];
+    tags: string[];
+    evidence: ConnectedPatternEvidence;
+    value: Record<string, unknown>;
+    baseWeight: number;
+}
+export interface ConnectedPatternCluster {
+    domain: 'frontend' | 'backend' | 'data';
+    concept: string;
+    signature: string;
+    key: string;
+    name: string;
+    summary: string;
+    score: number;
+    confidence: Confidence;
+    status: RecipeStatus;
+    instances: ConnectedPatternInstance[];
+    tags: string[];
+    dependencies: string[];
+    value: Record<string, unknown>;
+}
+export interface CssVariableValue {
+    name: string;
+    value: string;
+    selector?: string;
+    line: number;
+}
+export interface CssDeclaration {
+    property: string;
+    value: string;
+}
+export interface CssRuleDetail {
+    selector: string;
+    declarations: CssDeclaration[];
+    line: number;
+    media?: string;
+}
+export interface ClassExpression {
+    kind: 'attribute' | 'helper' | 'variant-definition' | 'string-literal';
+    raw: string;
+    classes: string[];
+    defaultClasses?: string[];
+    conditionalClasses?: string[];
+    line: number;
+    target?: string;
+    styleHelper?: string;
+    styleHelperVariants?: Record<string, string>;
+}
+export interface ClassSourceAnalysis {
+    classes: string[];
+    defaultClasses: string[];
+    conditionalClasses: string[];
+    decorativeAccentClasses: string[];
+}
+export interface ClassHelperUsage {
+    name: string;
+    variantProps: Record<string, string>;
+    call: string;
+}
+export interface StringLiteralRange {
+    value: string;
+    start: number;
+    end: number;
+}
+export interface ComponentStyleDefinition {
+    name: string;
+    kind: 'cva' | 'variant-object' | 'class-map';
+    line: number;
+    baseClasses: string[];
+    variants: Record<string, Record<string, string[]>>;
+    defaultVariants: Record<string, string>;
+    classes: string[];
+    source: string;
+}
+export interface ThemeToken {
+    path: string;
+    value: string;
+    type: 'color' | 'size' | 'font' | 'shadow' | 'radius' | 'spacing' | 'unknown';
+    line?: number;
+}
+export interface InlineStyle {
+    tag?: string;
+    line: number;
+    raw: string;
+    properties: CssDeclaration[];
+}
+export interface RegistryEntry {
+    key: string;
+    group: RecipeGroup;
+    summary: string;
+    tags: string[];
+    dependencies: string[];
+    usedBy: string[];
+    confidence: Confidence;
+    status: RecipeStatus;
+    path?: string;
+    value: Record<string, unknown>;
+}
+export interface GraphNode {
+    k: string;
+    kind: string;
+    name: string;
+    path?: string;
+    language?: string;
+    framework?: string;
+    facets?: Record<string, unknown>;
+    source?: SourceInfo;
+}
+export interface GraphEdge {
+    from: string;
+    to: string;
+    type: string;
+    confidence?: Confidence;
+    source?: SourceInfo;
+}
+export interface SourceInfo {
+    extractor: string;
+    confidence: Confidence;
+    evidence: string[];
+    path?: string;
+    hash?: string;
+}
+export interface ReviewItem {
+    id: string;
+    type: 'duplicate_key' | 'concept_collision' | 'role_collision' | 'stale_approval' | 'low_confidence' | 'missing_rule';
+    status: 'open' | 'resolved';
+    group?: string;
+    s: string;
+    candidates: string[];
+}
+export interface CodebaseBundle {
+    scanId: string;
+    generatedAt: string;
+    rootPath: string;
+    projectType: CodebaseProjectType;
+    files: AnalyzedFile[];
+    entries: RegistryEntry[];
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    reviewItems: ReviewItem[];
+    detected: {
+        languages: string[];
+        frameworks: string[];
+    };
+}
+export interface CodebaseManifest {
+    v: typeof bundleSchemaVersion;
+    scanId: string;
+    rootName: string;
+    projectType: CodebaseProjectType;
+    generatedAt: string;
+    localOnly: true;
+    schema: {
+        graph: typeof graphSchemaVersion;
+        index: typeof indexSchemaVersion;
+        recipe: typeof recipeSchemaVersion;
+    };
+    extractors: Array<{
+        id: string;
+        version: string;
+    }>;
+    stats: {
+        files: number;
+        nodes: number;
+        edges: number;
+        recipes: number;
+        reviewItems: number;
+    };
+    paths: {
+        nodes: string;
+        edges: string;
+        groups: string;
+        aliases: string;
+        terms: string;
+        review: string;
+    };
+}
+export interface RecipeRecord {
+    k: string;
+    g: RecipeGroup;
+    d: string[];
+    u: string[];
+    s: string;
+    t: string[];
+    p?: string;
+    confidence: Confidence;
+    status: RecipeStatus;
+    v: Record<string, unknown>;
+}
+export interface SearchMatch {
+    k: string;
+    g: string;
+    kind: string;
+    name?: string;
+    s: string;
+    t: string[];
+    d: string[];
+    u: string[];
+    p: string | null;
+    confidence: Confidence;
+    status: RecipeStatus;
+    score: number;
+    scores?: PatternScores;
+    decision?: PatternDecision;
+}