@schemyx/mcp 0.1.0 → 0.1.1

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

@@ -0,0 +1,522 @@
+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[]>;
+    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 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 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[];
+    childSummary?: UiElementChildSummary[];
+    id?: string;
+    role?: string;
+    type?: string;
+    href?: string;
+    action?: string;
+    method?: string;
+    props?: Record<string, string>;
+    variants?: Record<string, string>;
+    evidence: string;
+}
+export interface UiElementChildSummary {
+    index: number;
+    kind: string;
+    tag: string;
+    originalTag: string;
+    layoutRole?: string;
+    classes: string[];
+    defaultClasses?: string[];
+    conditionalClasses?: 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[]>;
+    };
+    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;
+}
+export interface ClassExpression {
+    kind: 'attribute' | 'helper' | 'variant-definition' | 'string-literal';
+    raw: string;
+    classes: string[];
+    defaultClasses?: string[];
+    conditionalClasses?: string[];
+    line: number;
+    target?: string;
+}
+export interface ClassSourceAnalysis {
+    classes: string[];
+    defaultClasses: string[];
+    conditionalClasses: string[];
+    decorativeAccentClasses: 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;
+}

package/dist/codebase-scanner/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/codebase-scanner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/codebase-scanner/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,37 @@
+import type { CodebaseProjectType } from './types';
+export declare function stringArrayValue(value: unknown): string[];
+export declare function toJsonLines(values: unknown[]): string;
+export declare function estimateTokens(value: unknown): number;
+export declare function cursorToOffset(value: unknown): number;
+export declare function lineNumberAt(content: string, index: number): number;
+export declare function truncate(value: string, maxLength: number): string;
+export declare function classBase(className: string): string;
+export declare function pathTerms(relPath: string): string[];
+export declare function toKebabCase(value: string): string;
+export declare function resolveRootPath(value: unknown): string;
+export declare function resolveOutputDir(rootPath: string, value: string): string;
+export declare function resolveInsideRoot(rootPath: string, value: string): string;
+export declare function isInsideRoot(rootPath: string, fullPath: string): boolean;
+export declare function pathExists(filePath: string): Promise<boolean>;
+export declare function requiredProjectType(value: unknown): CodebaseProjectType;
+export declare function requiredStringArg(value: unknown, name: string): string;
+export declare function stringArg(value: unknown): string | undefined;
+export declare function stringArrayArg(value: unknown): string[];
+export declare function numberArg(value: unknown, fallback: number, min: number, max: number): number;
+export declare function toRegistryKey(group: string, value: string): string;
+export declare function toPosixPath(value: string): string;
+export declare function stripLeadingDot(value: string): string;
+export declare function stripQuery(value: string): string;
+export declare function unique<T>(values: T[]): T[];
+export declare function uniqueBy<T>(values: T[], keyFn: (value: T) => string): T[];
+export declare function groupBy<T>(values: T[], keyFn: (value: T) => string): Map<string, T[]>;
+export declare function isPascalCase(value: string): boolean;
+export declare function isRelativeImport(value: string): boolean;
+export declare function resolveImportPath(fromRelPath: string, importValue: string, relPaths: Set<string>, rootPath: string): string | undefined;
+export declare function matchingNames(names: string[], value: string): string[];
+export declare function readAttr(attrs: string, name: string): string | undefined;
+export declare function titleCase(value: string): string;
+export declare function toPascalCase(value: string): string;
+export declare function escapeRegExp(value: string): string;
+export declare function shortHash(value: string): string;
+export declare function clampPatternScore(value: number): number;