vitek-plugin 0.2.0-beta → 0.2.2-beta

package/dist/core/contract/compare-asyncapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-asyncapi.d.ts","sourceRoot":"","sources":["../../../src/core/contract/compare-asyncapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkB7C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE,CA+BtF"}

package/dist/core/contract/compare-asyncapi.js

@@ -0,0 +1,45 @@
+import { sortKeysDeep } from './sort-json.js';
+function asRecord(value) {
+    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+        return value;
+    }
+    return {};
+}
+function getChannels(spec) {
+    return asRecord(asRecord(spec).channels);
+}
+function channelFingerprint(channel) {
+    return JSON.stringify(sortKeysDeep(channel));
+}
+export function compareAsyncApiSpecs(baseline, current) {
+    const issues = [];
+    const baseCh = getChannels(baseline);
+    const curCh = getChannels(current);
+    const keys = new Set([...Object.keys(baseCh), ...Object.keys(curCh)]);
+    for (const k of [...keys].sort()) {
+        if (baseCh[k] != null && curCh[k] == null) {
+            issues.push({
+                severity: 'error',
+                code: 'asyncapi_missing_channel',
+                message: `WebSocket channel removed from contract: ${k}`,
+            });
+        }
+        else if (baseCh[k] == null && curCh[k] != null) {
+            issues.push({
+                severity: 'warning',
+                code: 'asyncapi_new_channel',
+                message: `WebSocket channel not in baseline: ${k}`,
+            });
+        }
+        else if (baseCh[k] != null && curCh[k] != null) {
+            if (channelFingerprint(baseCh[k]) !== channelFingerprint(curCh[k])) {
+                issues.push({
+                    severity: 'error',
+                    code: 'asyncapi_channel_mismatch',
+                    message: `WebSocket channel definition drift: ${k}`,
+                });
+            }
+        }
+    }
+    return issues;
+}

package/dist/core/contract/compare-openapi.d.ts

@@ -0,0 +1,3 @@
+import type { DriftIssue } from './types.js';
+export declare function compareOpenApiSpecs(baseline: unknown, current: unknown): DriftIssue[];
+//# sourceMappingURL=compare-openapi.d.ts.map

package/dist/core/contract/compare-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-openapi.d.ts","sourceRoot":"","sources":["../../../src/core/contract/compare-openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwC7C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE,CAmFrF"}

package/dist/core/contract/compare-openapi.js

@@ -0,0 +1,116 @@
+import { OPENAPI_PATH_METHODS } from './http-methods.js';
+import { sortKeysDeep } from './sort-json.js';
+function asRecord(value) {
+    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+        return value;
+    }
+    return {};
+}
+function getPaths(spec) {
+    return asRecord(asRecord(spec).paths);
+}
+function listOperations(paths) {
+    const out = [];
+    for (const openApiPath of Object.keys(paths).sort()) {
+        const item = asRecord(paths[openApiPath]);
+        for (const method of Object.keys(item).sort()) {
+            if (!OPENAPI_PATH_METHODS.has(method))
+                continue;
+            out.push({ openApiPath, method });
+        }
+    }
+    return out;
+}
+function opKey(openApiPath, method) {
+    return `${method.toUpperCase()} ${openApiPath}`;
+}
+function getResponses(operation) {
+    const op = asRecord(operation);
+    return asRecord(op.responses);
+}
+function responseFingerprint(response) {
+    return JSON.stringify(sortKeysDeep(response));
+}
+export function compareOpenApiSpecs(baseline, current) {
+    const issues = [];
+    const basePaths = getPaths(baseline);
+    const curPaths = getPaths(current);
+    for (const openApiPath of Object.keys(basePaths).sort()) {
+        if (!curPaths[openApiPath]) {
+            issues.push({
+                severity: 'error',
+                code: 'missing_path',
+                message: `Path removed from contract: ${openApiPath}`,
+            });
+        }
+    }
+    for (const openApiPath of Object.keys(basePaths).sort()) {
+        if (!curPaths[openApiPath])
+            continue;
+        const baseItem = asRecord(basePaths[openApiPath]);
+        const curItem = asRecord(curPaths[openApiPath]);
+        for (const method of Object.keys(baseItem).sort()) {
+            if (!OPENAPI_PATH_METHODS.has(method))
+                continue;
+            if (curItem[method] == null) {
+                issues.push({
+                    severity: 'error',
+                    code: 'missing_method',
+                    message: `Operation removed from contract: ${opKey(openApiPath, method)}`,
+                });
+            }
+        }
+    }
+    const baseOps = listOperations(basePaths);
+    const curOps = listOperations(curPaths);
+    const baseSet = new Set(baseOps.map((o) => opKey(o.openApiPath, o.method)));
+    for (const { openApiPath, method } of curOps) {
+        const key = opKey(openApiPath, method);
+        if (!baseSet.has(key)) {
+            issues.push({
+                severity: 'warning',
+                code: 'undocumented_operation',
+                message: `Operation not in baseline (new or undocumented in snapshot): ${key}`,
+            });
+        }
+    }
+    for (const { openApiPath, method } of baseOps) {
+        if (!curPaths[openApiPath])
+            continue;
+        const baseItem = asRecord(basePaths[openApiPath]);
+        const curItem = asRecord(curPaths[openApiPath]);
+        if (curItem[method] == null)
+            continue;
+        const baseOp = baseItem[method];
+        const curOp = curItem[method];
+        const baseResp = getResponses(baseOp);
+        const curResp = getResponses(curOp);
+        const statuses = new Set([...Object.keys(baseResp), ...Object.keys(curResp)]);
+        for (const status of [...statuses].sort()) {
+            if (baseResp[status] != null && curResp[status] == null) {
+                issues.push({
+                    severity: 'error',
+                    code: 'missing_response_status',
+                    message: `Response ${status} missing for ${opKey(openApiPath, method)}`,
+                });
+            }
+            else if (baseResp[status] == null && curResp[status] != null) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'new_response_status',
+                    message: `New response status ${status} for ${opKey(openApiPath, method)}`,
+                });
+            }
+            else if (baseResp[status] != null && curResp[status] != null) {
+                if (responseFingerprint(baseResp[status]) !== responseFingerprint(curResp[status])) {
+                    issues.push({
+                        severity: 'error',
+                        code: 'response_schema_mismatch',
+                        message: `Response ${status} schema mismatch for ${opKey(openApiPath, method)}`,
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}

package/dist/core/contract/http-methods.d.ts

@@ -0,0 +1,2 @@
+export declare const OPENAPI_PATH_METHODS: Set<string>;
+//# sourceMappingURL=http-methods.d.ts.map

package/dist/core/contract/http-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-methods.d.ts","sourceRoot":"","sources":["../../../src/core/contract/http-methods.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,aAAqC,CAAC"}

package/dist/core/contract/http-methods.js

@@ -0,0 +1,2 @@
+import { HTTP_METHODS } from '../../shared/constants.js';
+export const OPENAPI_PATH_METHODS = new Set([...HTTP_METHODS]);

package/dist/core/contract/index.d.ts

@@ -0,0 +1,9 @@
+export type { DriftSeverity, DriftIssue } from './types.js';
+export { sortKeysDeep } from './sort-json.js';
+export { compareOpenApiSpecs } from './compare-openapi.js';
+export { compareAsyncApiSpecs } from './compare-asyncapi.js';
+export { loadProjectContractSpecs } from './project-specs.js';
+export declare const CONTRACT_DIR = ".vitek/contract";
+export declare const OPENAPI_SNAPSHOT_FILE = "openapi.snapshot.json";
+export declare const ASYNCAPI_SNAPSHOT_FILE = "asyncapi.snapshot.json";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/contract/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/contract/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAC9C,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,sBAAsB,2BAA2B,CAAC"}

package/dist/core/contract/index.js

@@ -0,0 +1,7 @@
+export { sortKeysDeep } from './sort-json.js';
+export { compareOpenApiSpecs } from './compare-openapi.js';
+export { compareAsyncApiSpecs } from './compare-asyncapi.js';
+export { loadProjectContractSpecs } from './project-specs.js';
+export const CONTRACT_DIR = '.vitek/contract';
+export const OPENAPI_SNAPSHOT_FILE = 'openapi.snapshot.json';
+export const ASYNCAPI_SNAPSHOT_FILE = 'asyncapi.snapshot.json';

package/dist/core/contract/project-specs.d.ts

@@ -0,0 +1,12 @@
+export interface ProjectContractSpecsOptions {
+    root: string;
+    apiDir: string;
+    apiBasePath: string;
+    socketBasePath: string;
+}
+export interface ProjectContractSpecs {
+    openApi: object;
+    asyncApi: object | null;
+}
+export declare function loadProjectContractSpecs(opts: ProjectContractSpecsOptions): ProjectContractSpecs;
+//# sourceMappingURL=project-specs.d.ts.map

package/dist/core/contract/project-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-specs.d.ts","sourceRoot":"","sources":["../../../src/core/contract/project-specs.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAeD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,2BAA2B,GAAG,oBAAoB,CAehG"}

package/dist/core/contract/project-specs.js

@@ -0,0 +1,27 @@
+import * as path from 'path';
+import { scanApiDirectory } from '../file-system/scan-api-dir.js';
+import { parsedRoutesToSchema } from '../generation/run-file-generation.js';
+import { generateOpenApiSpec } from '../openapi/generate.js';
+import { generateAsyncApiSpec } from '../asyncapi/generate.js';
+const STABLE_ASYNCAPI_SERVER = 'ws://127.0.0.1';
+function schemaToRouteForDocs(schema) {
+    return schema.map((s) => ({
+        pattern: s.pattern,
+        method: s.method,
+        params: s.params,
+        file: s.file,
+        bodyType: s.bodyType,
+        queryType: s.queryType,
+    }));
+}
+export function loadProjectContractSpecs(opts) {
+    const apiDirAbs = path.resolve(opts.root, opts.apiDir);
+    const scan = scanApiDirectory(apiDirAbs);
+    const schema = parsedRoutesToSchema(scan.routes);
+    const routesForDocs = schemaToRouteForDocs(schema);
+    const openApi = generateOpenApiSpec(routesForDocs, { apiBasePath: opts.apiBasePath });
+    const asyncApi = scan.sockets.length > 0
+        ? generateAsyncApiSpec(scan.sockets.map((s) => ({ pattern: s.pattern })), opts.socketBasePath, { serverUrl: STABLE_ASYNCAPI_SERVER })
+        : null;
+    return { openApi, asyncApi };
+}

package/dist/core/contract/sort-json.d.ts

@@ -0,0 +1,2 @@
+export declare function sortKeysDeep(value: unknown): unknown;
+//# sourceMappingURL=sort-json.d.ts.map

package/dist/core/contract/sort-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-json.d.ts","sourceRoot":"","sources":["../../../src/core/contract/sort-json.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAapD"}

package/dist/core/contract/sort-json.js

@@ -0,0 +1,14 @@
+export function sortKeysDeep(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(sortKeysDeep);
+    }
+    const obj = value;
+    const sorted = {};
+    for (const k of Object.keys(obj).sort()) {
+        sorted[k] = sortKeysDeep(obj[k]);
+    }
+    return sorted;
+}

package/dist/core/contract/types.d.ts

@@ -0,0 +1,7 @@
+export type DriftSeverity = 'error' | 'warning';
+export interface DriftIssue {
+    severity: DriftSeverity;
+    code: string;
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/contract/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/contract/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/core/contract/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/dispatch/dispatchers.d.ts

@@ -0,0 +1,4 @@
+import type { IssueDispatcher } from './types.js';
+export declare function createNoopIssueDispatcher(): IssueDispatcher;
+export declare function createConsoleIssueDispatcher(): IssueDispatcher;
+//# sourceMappingURL=dispatchers.d.ts.map

package/dist/core/dispatch/dispatchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchers.d.ts","sourceRoot":"","sources":["../../../src/core/dispatch/dispatchers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,YAAY,CAAC;AAE9D,wBAAgB,yBAAyB,IAAI,eAAe,CAI3D;AAED,wBAAgB,4BAA4B,IAAI,eAAe,CAY9D"}

package/dist/core/dispatch/dispatchers.js

@@ -0,0 +1,16 @@
+export function createNoopIssueDispatcher() {
+    return {
+        dispatch(_event) { },
+    };
+}
+export function createConsoleIssueDispatcher() {
+    return {
+        dispatch(event) {
+            console.log(JSON.stringify({
+                component: 'vitek',
+                event: 'issue.dispatch',
+                ...event,
+            }));
+        },
+    };
+}

package/dist/core/dispatch/emit-safe.d.ts

@@ -0,0 +1,3 @@
+import type { IssueDispatcher, IssueEvent } from './types.js';
+export declare function emitIssueSafe(dispatcher: IssueDispatcher | undefined, event: IssueEvent, onError?: (message: string, data?: Record<string, unknown>) => void): void;
+//# sourceMappingURL=emit-safe.d.ts.map

package/dist/core/dispatch/emit-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-safe.d.ts","sourceRoot":"","sources":["../../../src/core/dispatch/emit-safe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,aAAa,CAC3B,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAClE,IAAI,CAON"}

package/dist/core/dispatch/emit-safe.js

@@ -0,0 +1,10 @@
+export function emitIssueSafe(dispatcher, event, onError) {
+    if (!dispatcher)
+        return;
+    Promise.resolve(dispatcher.dispatch(event)).catch((err) => {
+        if (!onError)
+            return;
+        const message = err instanceof Error ? err.message : String(err);
+        onError('Issue dispatch failed', { message });
+    });
+}

package/dist/core/dispatch/index.d.ts

@@ -0,0 +1,4 @@
+export type { IssueSeverity, IssueSource, IssueSuggestion, IssueEvent, IssueDispatcher, } from './types.js';
+export { createNoopIssueDispatcher, createConsoleIssueDispatcher } from './dispatchers.js';
+export { emitIssueSafe } from './emit-safe.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/dispatch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/dispatch/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/dispatch/index.js

@@ -0,0 +1,2 @@
+export { createNoopIssueDispatcher, createConsoleIssueDispatcher } from './dispatchers.js';
+export { emitIssueSafe } from './emit-safe.js';

package/dist/core/dispatch/types.d.ts

@@ -0,0 +1,22 @@
+export type IssueSeverity = 'error' | 'warning' | 'info';
+export type IssueSource = 'runtime.http' | 'runtime.hook' | 'contract.check' | 'doctor' | 'manual';
+export interface IssueSuggestion {
+    title: string;
+    detail?: string;
+}
+export interface IssueEvent {
+    id: string;
+    timestamp: string;
+    severity: IssueSeverity;
+    source: IssueSource;
+    title: string;
+    message: string;
+    route?: string;
+    requestId?: string;
+    metadata?: Record<string, unknown>;
+    suggestions?: IssueSuggestion[];
+}
+export interface IssueDispatcher {
+    dispatch(event: IssueEvent): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/dispatch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/dispatch/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}

package/dist/core/dispatch/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/doctor/index.d.ts

@@ -0,0 +1,3 @@
+export type { DoctorDimensionResult, DoctorReport } from './types.js';
+export { buildDoctorReport } from './report.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/doctor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/doctor/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/doctor/index.js

@@ -0,0 +1 @@
+export { buildDoctorReport } from './report.js';

package/dist/core/doctor/report.d.ts

@@ -0,0 +1,4 @@
+import type { PlatformConfig } from '../../platform/config.js';
+import type { DoctorReport } from './types.js';
+export declare function buildDoctorReport(root: string, config: PlatformConfig): DoctorReport;
+//# sourceMappingURL=report.d.ts.map

package/dist/core/doctor/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/core/doctor/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAyB,YAAY,EAAE,MAAM,YAAY,CAAC;AAsHtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,YAAY,CAkBpF"}

package/dist/core/doctor/report.js

@@ -0,0 +1,166 @@
+import { DEFAULT_PLATFORM_CONFIG } from '../../platform/config.js';
+import { countTests, listProjectFiles } from './scan.js';
+function exists(files, rel) {
+    return files.includes(rel);
+}
+function startsWithAny(files, prefix) {
+    return files.some((f) => f.startsWith(prefix));
+}
+function contractsDimension(files) {
+    let score = 0;
+    const notes = [];
+    if (exists(files, '.vitek/contract/openapi.snapshot.json')) {
+        score += 10;
+    }
+    else {
+        notes.push('Add contract snapshot: vitek contract snapshot');
+    }
+    if (exists(files, '.vitek/contract/asyncapi.snapshot.json')) {
+        score += 5;
+    }
+    else {
+        notes.push('Add AsyncAPI snapshot when socket routes exist');
+    }
+    if (exists(files, 'docs/guide/contract.md')) {
+        score += 5;
+    }
+    else {
+        notes.push('Document contract checks');
+    }
+    return { name: 'Contracts', score, max: 20, notes };
+}
+function testsDimension(files) {
+    const tests = countTests(files);
+    let score = 0;
+    const notes = [];
+    if (tests >= 40)
+        score += 12;
+    else if (tests >= 20)
+        score += 8;
+    else if (tests >= 10)
+        score += 5;
+    else
+        notes.push('Increase automated test coverage');
+    if (startsWithAny(files, 'examples/') && files.some((f) => f.startsWith('examples/') && /\.(test|spec)\./.test(f))) {
+        score += 8;
+    }
+    else {
+        notes.push('Add example-level tests');
+    }
+    return { name: 'Tests', score, max: 20, notes };
+}
+function securityDimension(files) {
+    let score = 0;
+    const notes = [];
+    if (exists(files, 'docs/guide/security.md'))
+        score += 6;
+    else
+        notes.push('Add security guide');
+    if (exists(files, 'src/platform/redaction.ts'))
+        score += 5;
+    else
+        notes.push('Add/redesign redaction utilities');
+    if (DEFAULT_PLATFORM_CONFIG.ai.redaction.stripHeaders.length > 0 &&
+        DEFAULT_PLATFORM_CONFIG.ai.redaction.stripFields.length > 0) {
+        score += 4;
+    }
+    else {
+        notes.push('Define default redaction policy');
+    }
+    return { name: 'Security', score, max: 15, notes };
+}
+function observabilityDimension(files, config) {
+    let score = 0;
+    const notes = [];
+    if (exists(files, 'src/platform/correlation.ts'))
+        score += 4;
+    else
+        notes.push('Add request correlation layer');
+    if (exists(files, 'src/adapters/vite/logger.ts'))
+        score += 3;
+    else
+        notes.push('Add structured request logging');
+    if (config.features.observability)
+        score += 3;
+    else
+        notes.push('Enable features.observability when ready');
+    return { name: 'Observability', score, max: 10, notes };
+}
+function reliabilityDimension(files, config) {
+    let score = 0;
+    const notes = [];
+    if (exists(files, 'src/core/dispatch/types.ts'))
+        score += 4;
+    else
+        notes.push('Add issue/event dispatch contracts');
+    if (exists(files, 'src/core/events/event-bus.ts'))
+        score += 4;
+    else
+        notes.push('Add event bus');
+    if (exists(files, 'src/core/scheduler/runner.ts'))
+        score += 4;
+    else
+        notes.push('Add scheduler runner');
+    if (config.features.issueDispatch)
+        score += 3;
+    else
+        notes.push('Enable features.issueDispatch when sink is ready');
+    return { name: 'Reliability', score, max: 15, notes };
+}
+function docsDimension(files) {
+    let score = 0;
+    const notes = [];
+    if (exists(files, 'docs/ROADMAP-AI-PLATFORM.md'))
+        score += 4;
+    else
+        notes.push('Keep roadmap updated');
+    if (exists(files, 'docs/guide/ai-platform-config.md'))
+        score += 3;
+    else
+        notes.push('Document platform config');
+    if (exists(files, 'docs/guide/mcp-project.md'))
+        score += 3;
+    else
+        notes.push('Document MCP project flows');
+    return { name: 'Docs', score, max: 10, notes };
+}
+function architectureDimension(files) {
+    let score = 0;
+    const notes = [];
+    if (startsWithAny(files, 'src/core/contract/'))
+        score += 3;
+    else
+        notes.push('Missing contract module split');
+    if (startsWithAny(files, 'src/core/dispatch/'))
+        score += 3;
+    else
+        notes.push('Missing dispatch module split');
+    if (startsWithAny(files, 'src/core/events/'))
+        score += 2;
+    else
+        notes.push('Missing events module split');
+    if (startsWithAny(files, 'src/core/scheduler/'))
+        score += 2;
+    else
+        notes.push('Missing scheduler module split');
+    return { name: 'Architecture', score, max: 10, notes };
+}
+export function buildDoctorReport(root, config) {
+    const files = listProjectFiles(root);
+    const dimensions = [
+        contractsDimension(files),
+        testsDimension(files),
+        securityDimension(files),
+        observabilityDimension(files, config),
+        reliabilityDimension(files, config),
+        docsDimension(files),
+        architectureDimension(files),
+    ];
+    const score = dimensions.reduce((sum, d) => sum + d.score, 0);
+    const topActions = dimensions
+        .filter((d) => d.score < d.max)
+        .sort((a, b) => a.score / a.max - b.score / b.max)
+        .flatMap((d) => d.notes.map((n) => `${d.name}: ${n}`))
+        .slice(0, 5);
+    return { score, dimensions, topActions };
+}

package/dist/core/doctor/scan.d.ts

@@ -0,0 +1,3 @@
+export declare function listProjectFiles(root: string): string[];
+export declare function countTests(files: string[]): number;
+//# sourceMappingURL=scan.d.ts.map

package/dist/core/doctor/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/core/doctor/scan.ts"],"names":[],"mappings":"AAeA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIvD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAElD"}

package/dist/core/doctor/scan.js

@@ -0,0 +1,23 @@
+import * as fs from 'fs';
+import * as path from 'path';
+function walk(dir, out) {
+    if (!fs.existsSync(dir))
+        return;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walk(full, out);
+        }
+        else if (entry.isFile()) {
+            out.push(full);
+        }
+    }
+}
+export function listProjectFiles(root) {
+    const out = [];
+    walk(root, out);
+    return out.map((f) => path.relative(root, f).replace(/\\/g, '/'));
+}
+export function countTests(files) {
+    return files.filter((f) => /\.(test|spec)\.(ts|js|tsx|jsx|mjs|cjs)$/.test(f)).length;
+}

package/dist/core/doctor/types.d.ts

@@ -0,0 +1,12 @@
+export interface DoctorDimensionResult {
+    name: string;
+    score: number;
+    max: number;
+    notes: string[];
+}
+export interface DoctorReport {
+    score: number;
+    dimensions: DoctorDimensionResult[];
+    topActions: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/doctor/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/doctor/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/dist/core/doctor/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/events/event-bus.d.ts

@@ -0,0 +1,8 @@
+export type EventMap = Record<string, unknown>;
+export type EventHandler<TPayload> = (payload: TPayload) => void | Promise<void>;
+export interface EventBus<TEvents extends EventMap> {
+    on<TKey extends keyof TEvents>(event: TKey, handler: EventHandler<TEvents[TKey]>): () => void;
+    emit<TKey extends keyof TEvents>(event: TKey, payload: TEvents[TKey]): Promise<void>;
+}
+export declare function createEventBus<TEvents extends EventMap>(): EventBus<TEvents>;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/events/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../src/core/events/event-bus.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C,MAAM,MAAM,YAAY,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjF,MAAM,WAAW,QAAQ,CAAC,OAAO,SAAS,QAAQ;IAChD,EAAE,CAAC,IAAI,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAC9F,IAAI,CAAC,IAAI,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF;AAED,wBAAgB,cAAc,CAAC,OAAO,SAAS,QAAQ,KAAK,QAAQ,CAAC,OAAO,CAAC,CAuB5E"}