@mf-toolkit/shared-inspector 0.3.2 → 0.4.1

package/dist/cli/spinner.js

@@ -0,0 +1,45 @@
+// ─── Terminal spinner ─────────────────────────────────────────────────────────
+//
+// Uses braille frames for TTY, plain text for non-TTY / CI environments.
+// Does NOT use the injectable `write` — writes directly to process.stdout
+// so it can overwrite lines in place without interfering with the report output.
+import { isTTY, green, gray } from './colors.js';
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const INTERVAL_MS = 80;
+export function createSpinner() {
+    if (!isTTY) {
+        // Non-TTY (CI, piped): emit plain text lines via stdout
+        return {
+            start(text) { process.stdout.write(`  ${text}...\n`); },
+            succeed(text) { process.stdout.write(`  ✓ ${text}\n`); },
+            stop() { },
+        };
+    }
+    let frame = 0;
+    let timer;
+    function clearLine() {
+        process.stdout.write('\r\x1b[K'); // carriage return + erase to end of line
+    }
+    return {
+        start(text) {
+            process.stdout.write('\x1b[?25l'); // hide cursor
+            timer = setInterval(() => {
+                clearLine();
+                process.stdout.write(gray(`${FRAMES[frame % FRAMES.length]}  ${text}`));
+                frame++;
+            }, INTERVAL_MS);
+        },
+        succeed(text) {
+            clearInterval(timer);
+            clearLine();
+            process.stdout.write(`${green('✓')}  ${text}\n`);
+            process.stdout.write('\x1b[?25h'); // show cursor
+        },
+        stop() {
+            clearInterval(timer);
+            clearLine();
+            process.stdout.write('\x1b[?25h');
+        },
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/cli/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/cli/spinner.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,iFAAiF;AAEjF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAClE,MAAM,WAAW,GAAG,EAAE,CAAC;AAWvB,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,wDAAwD;QACxD,OAAO;YACL,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;YACxD,IAAI,KAAI,CAAC;SACV,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAiD,CAAC;IAEtD,SAAS,SAAS;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,yCAAyC;IAC7E,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI;YACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc;YACjD,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBACvB,SAAS,EAAE,CAAC;gBACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxE,KAAK,EAAE,CAAC;YACV,CAAC,EAAE,WAAW,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,IAAI;YACV,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;YACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc;QACnD,CAAC;QACD,IAAI;YACF,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/types.d.ts

@@ -0,0 +1,17 @@
+import type { SharedDepConfig } from '../types.js';
+export interface CliArgs {
+    command: 'project' | 'federation' | 'help' | 'version';
+    interactive: boolean;
+    sourceDirs: string[];
+    depth: 'direct' | 'local-graph';
+    sharedConfig?: Record<string, SharedDepConfig>;
+    tsconfigPath?: string;
+    workspacePackages: string[];
+    failOn?: 'mismatch' | 'unused' | 'any';
+    writeManifest: boolean;
+    outputDir: string;
+    name?: string;
+    manifestFiles: string[];
+}
+export type PromptFn = (question: string) => Promise<string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,WAAW,EAAE,OAAO,CAAC;IAErB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,QAAQ,GAAG,aAAa,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC"}

package/dist/cli/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export * from './cli/index.js';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,cAAc,gBAAgB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+export * from './cli/index.js';
+import { main } from './cli/index.js';
+const moduleUrl = new URL(import.meta.url);
+const scriptUrl = process.argv[1] ? new URL(process.argv[1], 'file://') : null;
+if (scriptUrl && moduleUrl.href === scriptUrl.href) {
+    main(process.argv.slice(2)).then((code) => { if (code !== 0)
+        process.exit(code); }, (err) => {
+        process.stderr.write(`Error: ${err.message}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAE/E,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACjD,CAAC,GAAU,EAAE,EAAE;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -5,5 +5,6 @@ export { inspect } from './inspect.js';
 export { formatReport, type FormatReportContext } from './reporter/format-report.js';
 export { formatFederationReport } from './reporter/format-federation-report.js';
 export { writeReport, writeManifest } from './reporter/write-report.js';
+export { scoreProjectReport, scoreFederationReport, type RiskScore } from './reporter/scoring.js';
 export type { ProjectManifest, ProjectReport, CollectorOptions, AnalysisOptions, SharedDepConfig, PackageOccurrence, UnusedEntry, CandidateEntry, MismatchedEntry, SingletonRiskEntry, EagerRiskEntry, FederationAnalysisOptions, FederationReport, GhostShareEntry, HostGapEntry, VersionConflictEntry, SingletonMismatchEntry, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGxE,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlG,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -8,4 +8,5 @@ export { inspect } from './inspect.js';
 export { formatReport } from './reporter/format-report.js';
 export { formatFederationReport } from './reporter/format-federation-report.js';
 export { writeReport, writeManifest } from './reporter/write-report.js';
+export { scoreProjectReport, scoreFederationReport } from './reporter/scoring.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAA4B,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAA4B,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAkB,MAAM,uBAAuB,CAAC"}

package/dist/reporter/diagnostics.d.ts

@@ -0,0 +1,23 @@
+export interface DiagnosticInfo {
+    /** One-line risk description shown after "→ Risk:" */
+    risk: string;
+}
+export type IssueKind = 'mismatch' | 'unused' | 'candidate' | 'singleton-risk' | 'eager-risk';
+export declare function getDiagnostic(pkg: string, kind: IssueKind): DiagnosticInfo;
+export interface FixConfig {
+    singleton?: boolean;
+    requiredVersion?: string;
+    eager?: boolean;
+}
+/**
+ * Returns a ready-to-paste webpack/rspack shared config snippet.
+ *
+ * @example
+ * buildFixSnippet('react', { singleton: true, requiredVersion: '^18.2.0' })
+ * // →
+ * // shared: {
+ * //   react: { singleton: true, requiredVersion: "^18.2.0" }
+ * // }
+ */
+export declare function buildFixSnippet(pkg: string, cfg?: FixConfig): string;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/reporter/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/reporter/diagnostics.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,QAAQ,GACR,WAAW,GACX,gBAAgB,GAChB,YAAY,CAAC;AAkHjB,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,cAAc,CAG1E;AAID,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,SAAc,GAAG,MAAM,CAQxE"}

package/dist/reporter/diagnostics.js

@@ -0,0 +1,138 @@
+// ─── Diagnostics knowledge base ──────────────────────────────────────────────
+//
+// Maps (package, issue-kind) → { risk description, fix snippet hint }.
+// Used by formatReport / formatFederationReport to produce actionable output.
+// ─── Per-package knowledge ────────────────────────────────────────────────────
+const PACKAGE_DIAGNOSTICS = {
+    react: {
+        mismatch: 'Invalid hook call, broken context across MFs',
+        candidate: 'Multiple React copies → invalid hook call',
+        'singleton-risk': 'Multiple React instances → invalid hook call, broken context',
+        'eager-risk': 'Duplicate React before negotiation completes → invalid hook call',
+        unused: 'React is consumed by JSX transform — removing may break JSX in remotes',
+    },
+    'react-dom': {
+        mismatch: 'Rendering broken — host and remote use different ReactDOM',
+        candidate: 'Multiple ReactDOM copies → broken rendering',
+        'singleton-risk': 'Multiple ReactDOM instances → broken rendering, portals fail',
+        unused: 'ReactDOM is consumed implicitly — removing may break renders in remotes',
+    },
+    'react-router': {
+        mismatch: 'Router version mismatch → broken navigation, hooks (useParams, useNavigate) broken',
+        candidate: 'Each MF has its own router instance → history state conflicts',
+        'singleton-risk': 'Multiple router instances → navigation conflicts between MFs',
+        unused: 'Route declarations in the remote may silently stop working',
+    },
+    'react-router-dom': {
+        mismatch: 'Router version mismatch → broken navigation',
+        candidate: 'Each MF has its own router → useNavigate / useParams broken cross-MF',
+        'singleton-risk': 'Multiple router instances → useNavigate / useParams broken',
+        unused: 'Link and Route components may stop working in other MFs',
+    },
+    mobx: {
+        mismatch: 'Observable state won\'t sync — MFs run different MobX versions',
+        candidate: 'Each MF gets its own MobX — observables and reactions won\'t sync between MFs',
+        'singleton-risk': 'Multiple MobX instances → cross-MF reactions won\'t fire, state isolated',
+        unused: 'MobX stores in the remote will be untracked',
+    },
+    'mobx-react': {
+        mismatch: 'observer() wraps components from different MobX instances',
+        candidate: 'Multiple mobx-react copies → observer() connects to wrong store instance',
+        'singleton-risk': 'Multiple mobx-react instances → observer() binds to isolated store',
+    },
+    'mobx-react-lite': {
+        mismatch: 'useObserver connects to wrong MobX instance',
+        candidate: 'Each MF gets its own observer binding',
+        'singleton-risk': 'Multiple mobx-react-lite → useObserver connects to wrong store',
+    },
+    redux: {
+        mismatch: 'Redux version mismatch → dispatch / subscribe API incompatible',
+        candidate: 'Each MF creates its own store — actions won\'t propagate across MFs',
+        'singleton-risk': 'Multiple Redux stores → dispatches won\'t propagate cross-MF',
+    },
+    '@reduxjs/toolkit': {
+        mismatch: 'RTK version mismatch → createSlice / createAsyncThunk API differences',
+        candidate: 'Each MF bundles its own RTK — separate store instances, no shared state',
+        'singleton-risk': 'Multiple RTK instances → slices belong to different stores',
+    },
+    zustand: {
+        mismatch: 'Zustand API mismatch → store subscriptions may not work correctly',
+        candidate: 'Each MF gets its own Zustand store — state not shared across MFs',
+        'singleton-risk': 'Multiple Zustand instances → store subscriptions not shared',
+    },
+    jotai: {
+        candidate: 'Each MF gets its own Jotai atom scope — atoms won\'t sync',
+        'singleton-risk': 'Multiple Jotai instances → atoms not shared between MFs',
+    },
+    recoil: {
+        candidate: 'Each MF gets its own Recoil root — atoms isolated per MF',
+        'singleton-risk': 'Multiple Recoil instances → RecoilRoot state not shared',
+    },
+    vue: {
+        mismatch: 'Vue runtime mismatch → app.use() and composables broken',
+        candidate: 'Each MF bundles Vue — composables won\'t share reactive state',
+        'singleton-risk': 'Multiple Vue runtimes → provide/inject across MFs broken',
+    },
+    'vue-router': {
+        mismatch: 'Router version mismatch → navigation guards and hooks broken',
+        candidate: 'Each MF has its own Vue Router instance → navigation conflicts',
+        'singleton-risk': 'Multiple router instances → useRoute / useRouter broken cross-MF',
+    },
+    'styled-components': {
+        mismatch: 'Style injection broken — className collisions between MFs',
+        candidate: 'Each MF bundles its own styled-components — class name conflicts in SSR',
+        'singleton-risk': 'Multiple styled-components → theme context not shared, class collisions',
+    },
+    '@emotion/react': {
+        mismatch: 'Emotion cache mismatch → styles not injected correctly across MFs',
+        candidate: 'Each MF has its own Emotion cache — styles may conflict or duplicate',
+        'singleton-risk': 'Multiple Emotion instances → theme context not shared, styles broken',
+    },
+    '@emotion/styled': {
+        mismatch: 'Emotion version mismatch → styled components lose theme context',
+        candidate: 'Each MF bundles @emotion/styled independently',
+        'singleton-risk': 'Multiple Emotion instances → styled components lose theme context',
+    },
+    '@tanstack/react-query': {
+        candidate: 'Each MF has its own QueryClient → no shared cache, duplicate requests',
+        'singleton-risk': 'Multiple QueryClient instances → cache not shared between MFs',
+    },
+    swr: {
+        candidate: 'Each MF has its own SWR cache → duplicate fetches, no deduplication',
+        'singleton-risk': 'Multiple SWR instances → cache not shared between MFs',
+    },
+};
+// ─── Generic fallbacks ────────────────────────────────────────────────────────
+const GENERIC_RISK = {
+    mismatch: 'Version mismatch may cause runtime errors or silent incompatibilities',
+    unused: 'Wastes bundle negotiation overhead with no import benefit',
+    candidate: 'Each MF bundles its own copy — larger bundles, possible state desync',
+    'singleton-risk': 'Duplicate instances may cause unexpected runtime behavior',
+    'eager-risk': 'Eager loading without singleton risks duplicate instances during negotiation',
+};
+export function getDiagnostic(pkg, kind) {
+    const risk = PACKAGE_DIAGNOSTICS[pkg]?.[kind] ?? GENERIC_RISK[kind];
+    return { risk };
+}
+/**
+ * Returns a ready-to-paste webpack/rspack shared config snippet.
+ *
+ * @example
+ * buildFixSnippet('react', { singleton: true, requiredVersion: '^18.2.0' })
+ * // →
+ * // shared: {
+ * //   react: { singleton: true, requiredVersion: "^18.2.0" }
+ * // }
+ */
+export function buildFixSnippet(pkg, cfg = {}) {
+    const entries = [];
+    if (cfg.singleton)
+        entries.push('singleton: true');
+    if (cfg.requiredVersion)
+        entries.push(`requiredVersion: "${cfg.requiredVersion}"`);
+    if (cfg.eager)
+        entries.push('eager: true');
+    const inner = entries.length > 0 ? ` { ${entries.join(', ')} }` : ' {}';
+    return `shared: {\n  ${pkg}:${inner}\n}`;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/reporter/diagnostics.js.map

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

package/dist/reporter/format-federation-report.d.ts

@@ -1,12 +1,18 @@
 import type { FederationReport } from '../types.js';
 /**
- * Formats a FederationReport as a human-readable terminal string.
+ * Formats a FederationReport as actionable diagnostic cards.
+ *
+ * Each finding shows:
+ *   - Issue title + package name
+ *   - Which MFs are involved
+ *   - Risk description (what breaks at runtime)
+ *   - Ready-to-paste fix snippet
  *
  * Section order (by severity):
- *   1. Version conflicts    — deterministic, most dangerous (silent broken singleton)
- *   2. Singleton mismatches — deterministic, runtime risk
- *   3. Host gaps            — heuristic, bundle duplication
- *   4. Ghost shares         — heuristic, dead coupling
+ *   1. Version conflicts    — most dangerous, singleton negotiation fails silently
+ *   2. Singleton mismatches — runtime risk, unpredictable instance selection
+ *   3. Host gaps            — bundle duplication, no shared state
+ *   4. Ghost shares         — dead coupling, safe to remove
  *   5. Summary line
  */
 export declare function formatFederationReport(report: FederationReport): string;

package/dist/reporter/format-federation-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-federation-report.d.ts","sourceRoot":"","sources":["../../src/reporter/format-federation-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgFvE"}
+{"version":3,"file":"format-federation-report.d.ts","sourceRoot":"","sources":["../../src/reporter/format-federation-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAC;AAM1E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAiGvE"}

package/dist/reporter/format-federation-report.js

@@ -1,72 +1,97 @@
+import { getDiagnostic, buildFixSnippet } from './diagnostics.js';
+import { scoreFederationReport, formatScoreBlock } from './scoring.js';
+const HR = '─'.repeat(60);
 /**
- * Formats a FederationReport as a human-readable terminal string.
+ * Formats a FederationReport as actionable diagnostic cards.
+ *
+ * Each finding shows:
+ *   - Issue title + package name
+ *   - Which MFs are involved
+ *   - Risk description (what breaks at runtime)
+ *   - Ready-to-paste fix snippet
  *
  * Section order (by severity):
- *   1. Version conflicts    — deterministic, most dangerous (silent broken singleton)
- *   2. Singleton mismatches — deterministic, runtime risk
- *   3. Host gaps            — heuristic, bundle duplication
- *   4. Ghost shares         — heuristic, dead coupling
+ *   1. Version conflicts    — most dangerous, singleton negotiation fails silently
+ *   2. Singleton mismatches — runtime risk, unpredictable instance selection
+ *   3. Host gaps            — bundle duplication, no shared state
+ *   4. Ghost shares         — dead coupling, safe to remove
  *   5. Summary line
  */
 export function formatFederationReport(report) {
     const lines = [];
     const { ghostShares, hostGaps, versionConflicts, singletonMismatches, summary } = report;
-    // ── Header ─────────────────────────────────────────────────────────────────
-    lines.push('', `[MfSharedInspector] federation analysis (${summary.totalManifests} MFs)`, '');
+    lines.push('', `[MfSharedInspector] federation analysis (${summary.totalManifests} MFs)`, HR, '');
     const hasFindings = versionConflicts.length > 0 ||
         singletonMismatches.length > 0 ||
         hostGaps.length > 0 ||
         ghostShares.length > 0;
     if (!hasFindings) {
-        lines.push('  No federation-level issues found.');
+        lines.push('  ✓  No federation-level issues found. Everything looks consistent.');
+        lines.push('');
+        lines.push(HR);
+        lines.push(formatScoreBlock(scoreFederationReport(report), 'version conflicts', 'singleton mismatches, host gaps', 'ghost shares'));
         lines.push('');
-        lines.push(`  Total: ${summary.totalManifests} MFs analysed, everything looks consistent.`);
+        lines.push(`Total: ${summary.totalManifests} MFs analysed, 0 issues.`);
         lines.push('');
         return lines.join('\n');
     }
     // ── 1. Version conflicts ───────────────────────────────────────────────────
-    if (versionConflicts.length > 0) {
-        lines.push('  Version conflicts (singleton negotiation will fail):');
-        for (const c of versionConflicts) {
-            const versions = Object.entries(c.versions)
-                .map(([mf, v]) => `${mf}: ${v}`)
-                .join(', ');
-            lines.push(`    ⚠ ${c.package} — ${versions}`);
+    for (const c of versionConflicts) {
+        const { risk } = getDiagnostic(c.package, 'mismatch');
+        lines.push(`⚠  Version Conflict — ${c.package}`);
+        for (const [mf, v] of Object.entries(c.versions)) {
+            lines.push(`   ${mf}: ${v}`);
+        }
+        lines.push(`   → Risk: MF singleton negotiation will silently load wrong version → ${risk}`);
+        lines.push(`   💡 Fix: Align requiredVersion across all MFs:`);
+        const best = pickHighestRequiredVersion(c);
+        for (const l of buildFixSnippet(c.package, { singleton: true, requiredVersion: best }).split('\n')) {
+            lines.push(`   ${l}`);
         }
         lines.push('');
     }
     // ── 2. Singleton mismatches ────────────────────────────────────────────────
-    if (singletonMismatches.length > 0) {
-        lines.push('  Singleton mismatches (add singleton: true to all MFs):');
-        for (const s of singletonMismatches) {
-            lines.push(`    ⚠ ${s.package} — singleton in [${s.singletonIn.join(', ')}], not singleton in [${s.nonSingletonIn.join(', ')}]`);
-        }
+    for (const s of singletonMismatches) {
+        const { risk } = getDiagnostic(s.package, 'singleton-risk');
+        lines.push(`⚠  Singleton Mismatch — ${s.package}`);
+        lines.push(`   singleton in: [${s.singletonIn.join(', ')}]`);
+        lines.push(`   not singleton in: [${s.nonSingletonIn.join(', ')}]`);
+        lines.push(`   → Risk: ${risk}`);
+        lines.push(`   💡 Fix: Add singleton: true to all MFs that share ${s.package}`);
         lines.push('');
     }
     // ── 3. Host gaps ───────────────────────────────────────────────────────────
-    if (hostGaps.length > 0) {
-        lines.push('  Host gaps (add to shared — each MF bundles its own copy):');
-        for (const g of hostGaps) {
-            lines.push(`    → ${g.package} — used by [${g.missingIn.join(', ')}], not in shared`);
+    for (const g of hostGaps) {
+        const { risk } = getDiagnostic(g.package, 'candidate');
+        lines.push(`→  Host Gap — ${g.package}`);
+        lines.push(`   used by: [${g.missingIn.join(', ')}], not in shared config`);
+        lines.push(`   → Risk: ${risk}`);
+        lines.push(`   💡 Fix:`);
+        for (const l of buildFixSnippet(g.package, { singleton: true }).split('\n')) {
+            lines.push(`   ${l}`);
         }
         lines.push('');
     }
     // ── 4. Ghost shares ────────────────────────────────────────────────────────
-    if (ghostShares.length > 0) {
-        lines.push('  Ghost shares (remove from shared — no other MF benefits):');
-        for (const g of ghostShares) {
-            if (g.usedUnsharedBy.length > 0) {
-                lines.push(`    ✗ ${g.package} — shared only by ${g.sharedBy}, ` +
-                    `used unshared by [${g.usedUnsharedBy.join(', ')}]`);
-            }
-            else {
-                lines.push(`    ✗ ${g.package} — shared only by ${g.sharedBy}, unused by all other MFs`);
-            }
+    for (const g of ghostShares) {
+        lines.push(`✗  Ghost Share — ${g.package}`);
+        lines.push(`   shared only by: ${g.sharedBy}`);
+        if (g.usedUnsharedBy.length > 0) {
+            lines.push(`   used unshared by: [${g.usedUnsharedBy.join(', ')}]`);
         }
+        else {
+            lines.push(`   unused by all other MFs`);
+        }
+        lines.push(`   → One-sided coupling with no federation benefit`);
+        lines.push(`   💡 Fix: Remove "${g.package}" from ${g.sharedBy}'s shared config`);
         lines.push('');
     }
-    // ── 5. Summary ─────────────────────────────────────────────────────────────
-    lines.push(`  Total: ${summary.totalManifests} MFs, ` +
+    // ── 5. Score + Summary ───────────────────────────────────────────────────
+    const score = scoreFederationReport(report);
+    lines.push(HR);
+    lines.push(formatScoreBlock(score, 'version conflicts', 'singleton mismatches, host gaps', 'ghost shares'));
+    lines.push('');
+    lines.push(`Total: ${summary.totalManifests} MFs, ` +
         `${summary.versionConflictsCount} version conflicts, ` +
         `${summary.singletonMismatchesCount} singleton mismatches, ` +
         `${summary.hostGapsCount} host gaps, ` +
@@ -74,4 +99,20 @@ export function formatFederationReport(report) {
     lines.push('');
     return lines.join('\n');
 }
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/** Pick the version string with the highest semver major (and minor) as the suggested fix. */
+function pickHighestRequiredVersion(c) {
+    const versions = Object.values(c.versions);
+    const sorted = versions.slice().sort((a, b) => {
+        const clean = (v) => v.replace(/^[\^~>=<\s]+/, '').split('.').map(Number);
+        const [aMaj = 0, aMin = 0, aPatch = 0] = clean(a);
+        const [bMaj = 0, bMin = 0, bPatch = 0] = clean(b);
+        if (bMaj !== aMaj)
+            return bMaj - aMaj;
+        if (bMin !== aMin)
+            return bMin - aMin;
+        return bPatch - aPatch;
+    });
+    return sorted[0];
+}
 //# sourceMappingURL=format-federation-report.js.map

package/dist/reporter/format-federation-report.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-federation-report.js","sourceRoot":"","sources":["../../src/reporter/format-federation-report.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"format-federation-report.js","sourceRoot":"","sources":["../../src/reporter/format-federation-report.ts"],"names":[],"mappings":"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"}

package/dist/reporter/format-report.d.ts

@@ -5,14 +5,21 @@ export interface FormatReportContext {
     filesScanned?: number;
 }
 /**
- * Formats a ProjectReport as a human-readable terminal string.
+ * Formats a ProjectReport as actionable diagnostic cards.
  *
- * Section order (by severity / determinism):
- *   1. Version mismatch  — deterministic, most dangerous
- *   2. Unused shared     — deterministic, easy wins
- *   3. Candidates        — heuristic, actionable suggestions
- *   4. Singleton risks   — heuristic, potential runtime issues
- *   5. Summary line
+ * Each finding is rendered as a card with:
+ *   - Issue title + package name
+ *   - Concrete detail (version numbers, import count, etc.)
+ *   - Risk description (what breaks at runtime)
+ *   - Ready-to-paste fix snippet
+ *
+ * Section order (by severity):
+ *   1. Version mismatch  — most dangerous, sharing silently broken
+ *   2. Unused shared     — easy wins, safe to remove
+ *   3. Candidates        — not shared but should be
+ *   4. Singleton risks   — missing singleton: true
+ *   5. Eager risks       — eager without singleton
+ *   6. Summary line
  */
 export declare function formatReport(report: ProjectReport, ctx?: FormatReportContext): string;
 //# sourceMappingURL=format-report.d.ts.map

package/dist/reporter/format-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-report.d.ts","sourceRoot":"","sources":["../../src/reporter/format-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,MAAM,CA6ErF"}
+{"version":3,"file":"format-report.d.ts","sourceRoot":"","sources":["../../src/reporter/format-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAqGrF"}