@openora/mcp 0.4.1-canary.33 → 0.4.1-canary.331

package/dist/dep-graph.js

@@ -0,0 +1,131 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, posix } from 'node:path';
+const WORKSPACE_ROOTS = ['apps', 'packages'];
+const CONFIG = '.dependency-cruiser.cjs';
+function cruise(cwd, targets) {
+    const out = execFileSync('pnpm', ['exec', 'depcruise', ...targets, '--config', CONFIG, '--output-type', 'json'], { cwd, maxBuffer: 512 * 1024 * 1024 });
+    return JSON.parse(out.toString()).modules;
+}
+// A consumer repo keeps one config per workspace; the platform repo keeps one at the root.
+function cruiseRuns(root) {
+    const workspaces = WORKSPACE_ROOTS.filter((r) => existsSync(join(root, r))).flatMap((r) => readdirSync(join(root, r))
+        .map((name) => `${r}/${name}`)
+        .filter((dir) => existsSync(join(root, dir, CONFIG))));
+    if (workspaces.length > 0) {
+        return workspaces.map((dir) => ({
+            dir,
+            targets: [existsSync(join(root, dir, 'src')) ? 'src' : '.'],
+        }));
+    }
+    if (!existsSync(join(root, CONFIG))) {
+        throw new Error(`No ${CONFIG} at ${root} or in any of ${WORKSPACE_ROOTS.join('/')}/*`);
+    }
+    return [{ dir: '.', targets: WORKSPACE_ROOTS.filter((r) => existsSync(join(root, r))) }];
+}
+// `exports` point at dist; the graph speaks source, so map each entry back to its src file.
+function publishedEntryPoints(root) {
+    const entries = {};
+    const packagesDir = join(root, 'packages');
+    if (!existsSync(packagesDir)) {
+        return entries;
+    }
+    for (const name of readdirSync(packagesDir)) {
+        const manifestPath = join(packagesDir, name, 'package.json');
+        if (!existsSync(manifestPath)) {
+            continue;
+        }
+        const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+        if (!manifest.name?.startsWith('@openora/') || manifest.private) {
+            continue;
+        }
+        for (const [key, target] of Object.entries(manifest.exports ?? {})) {
+            const importPath = typeof target === 'string' ? target : target?.import;
+            const dist = importPath?.match(/^\.\/dist\/(.+)\.js$/)?.[1];
+            if (!dist) {
+                continue;
+            }
+            const source = ['ts', 'tsx']
+                .map((ext) => `packages/${name}/src/${dist}.${ext}`)
+                .find((file) => existsSync(join(root, file)));
+            if (source) {
+                entries[source] = manifest.name + key.slice(1);
+            }
+        }
+    }
+    return entries;
+}
+export function buildDepGraph(root) {
+    const dependents = {};
+    const platform = {};
+    for (const { dir, targets } of cruiseRuns(root)) {
+        const toRepoPath = (source) => posix.normalize(`${dir}/${source}`);
+        // Linked or installed @openora/* resolve outside the repo; the graph covers the repo's own files.
+        const isInternal = (d, path) => !d.coreModule &&
+            !d.couldNotResolve &&
+            !path.includes('node_modules/') &&
+            !toRepoPath(path).startsWith('../');
+        for (const module of cruise(join(root, dir), targets)) {
+            if (!isInternal(module, module.source)) {
+                continue;
+            }
+            const file = toRepoPath(module.source);
+            for (const dependency of module.dependencies) {
+                if (isInternal(dependency, dependency.resolved)) {
+                    (dependents[toRepoPath(dependency.resolved)] ??= new Set()).add(file);
+                }
+                else if (dependency.module.startsWith('@openora/')) {
+                    (platform[file] ??= new Set()).add(dependency.module);
+                }
+            }
+        }
+    }
+    const sorted = (map) => Object.fromEntries(Object.entries(map)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([file, values]) => [file, [...values].sort()]));
+    return {
+        generatedAt: new Date().toISOString(),
+        commit: process.env['CI_COMMIT_SHA'] ?? process.env['GITHUB_SHA'] ?? null,
+        dependents: sorted(dependents),
+        platform: sorted(platform),
+        entryPoints: publishedEntryPoints(root),
+    };
+}
+/** Transitive importers of `file`, up to `maxDepth` hops, nearest first. */
+export function importersOf(graph, file, maxDepth) {
+    const depth = new Map([[file, 0]]);
+    const queue = [file];
+    for (let current = queue.shift(); current !== undefined; current = queue.shift()) {
+        const level = depth.get(current) ?? 0;
+        if (level >= maxDepth) {
+            continue;
+        }
+        for (const importer of graph.dependents[current] ?? []) {
+            if (!depth.has(importer)) {
+                depth.set(importer, level + 1);
+                queue.push(importer);
+            }
+        }
+    }
+    depth.delete(file);
+    return [...depth.keys()];
+}
+/**
+ * What a change to `file` can break. With a consumer graph, a platform file is followed through
+ * the public entry points it reaches into the consumer files that import them - the cross-repo
+ * half that no single-repo graph shows.
+ */
+export function impactOf(graph, file, maxDepth, consumer) {
+    const importers = importersOf(graph, file, maxDepth);
+    // Nearest first: a change reaches its own entry point before the barrels that re-export it.
+    const specifiers = [...new Set([file, ...importers].flatMap((f) => graph.entryPoints[f] ?? []))];
+    const rank = (specs) => Math.min(...specs.map((s) => specifiers.indexOf(s)).filter((i) => i >= 0));
+    const consumerFiles = consumer
+        ? Object.entries(consumer.platform)
+            .filter(([, specs]) => specs.some((s) => specifiers.includes(s)))
+            .sort(([a, x], [b, y]) => rank(x) - rank(y) || a.localeCompare(b))
+            .map(([f]) => f)
+        : [];
+    return { file, importers, specifiers, consumerFiles };
+}
+//# sourceMappingURL=dep-graph.js.map

package/dist/dep-graph.js.map

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

package/dist/intent.d.ts

@@ -0,0 +1,3 @@
+export type IntentKind = 'feature' | 'adapter' | 'ui-page' | 'route' | 'unsure';
+export declare function classifyIntent(ask: string): IntentKind;
+//# sourceMappingURL=intent.d.ts.map

package/dist/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../src/intent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAoBtD"}

package/dist/intent.js

@@ -0,0 +1,18 @@
+export function classifyIntent(ask) {
+    const a = ` ${ask.toLowerCase()} `;
+    const has = (re) => re.test(a);
+    if (has(/\b(payment|psp|stripe|adyen|kyc|onfido|sms|email|notification|vendor|adapter|gateway)\b/)) {
+        return 'adapter';
+    }
+    if (has(/\b(page|screen|dashboard|view|frontend|admin panel|backoffice page|player page)\b/)) {
+        return 'ui-page';
+    }
+    if (has(/\b(endpoint|route|procedure|api method|rpc)\b/)) {
+        return 'route';
+    }
+    if (has(/\b(feature|module|tournament|leaderboard|jackpot|loyalty|bonus|cashback|mission|reward)\b/)) {
+        return 'feature';
+    }
+    return 'unsure';
+}
+//# sourceMappingURL=intent.js.map

package/dist/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../src/intent.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,IACE,GAAG,CAAC,yFAAyF,CAAC,EAC9F,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,mFAAmF,CAAC,EAAE,CAAC;QAC7F,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,+CAA+C,CAAC,EAAE,CAAC;QACzD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IACE,GAAG,CAAC,2FAA2F,CAAC,EAChG,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/main.js

@@ -5,7 +5,36 @@ import { existsSync, readFileSync } from 'node:fs';
 import { execSync } from 'node:child_process';
 import { dirname, join, parse } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { buildDepGraph, impactOf } from './dep-graph.js';
+import { classifyIntent } from './intent.js';
 const here = dirname(fileURLToPath(import.meta.url));
+const ownPackage = JSON.parse(readFileSync(join(here, '..', 'package.json'), 'utf8'));
+const formatIam = (iam) => iam ? `${iam.resource}:${iam.action}` : '(non-literal)';
+function formatAgentTool(t) {
+    return [
+        `- ${t.id}  [${t.class ?? '?'}, v${t.schemaVersion ?? '?'}, iam ${formatIam(t.iam)}, module ${t.module}]`,
+        ...(t.title || t.description
+            ? [`    ${[t.title, t.description].filter(Boolean).join(' - ')}`]
+            : []),
+    ];
+}
+function formatAgentAction(a) {
+    const reversibility = a.reversible === null ? 'reversible ?' : a.reversible ? 'reversible' : 'irreversible';
+    const benefit = a.benefitsPlayer === null
+        ? ', benefits player ?'
+        : a.benefitsPlayer
+            ? ', benefits player'
+            : a.benefitsPlayerWhen
+                ? `, benefits player when ${a.benefitsPlayerWhen.field} is ${a.benefitsPlayerWhen.values.join(' or ')}`
+                : '';
+    const distinct = a.distinctBy ? `, distinct by ${a.distinctBy}` : '';
+    return [
+        `- ${a.id}  [${reversibility}${benefit}${distinct}, v${a.schemaVersion ?? '?'}, iam ${formatIam(a.iam)}, module ${a.module}]`,
+        ...(a.title || a.description
+            ? [`    ${[a.title, a.description].filter(Boolean).join(' - ')}`]
+            : []),
+    ];
+}
 const NOT_FOUND_MESSAGE = 'catalog.json not found - run `pnpm regen` in the platform repo, or set OSS_CATALOG to its path.';
 function catalogCandidates() {
     const candidates = [];
@@ -54,16 +83,16 @@ function withCatalog(fn) {
 }
 const server = new McpServer({
     name: 'oss',
-    version: '0.1.0',
+    version: ownPackage.version,
 });
 server.registerTool('catalog-overview', {
-    description: 'START HERE. A concise "what can I extend" summary of the OSS igaming platform you are consuming: counts of modules/events/slots/schemas, the adapter swap-seam table (category/interface/token/status), and the igaming-config fields. Read this first to orient before drilling into the other tools.',
+    description: 'START HERE. A concise "what can I extend" summary of the OSS igaming platform you are consuming: counts of modules/events/schemas, the adapter swap-seam table (category/interface/token/status), and the igaming-config fields. Read this first to orient before drilling into the other tools.',
     inputSchema: {},
 }, withCatalog((c) => {
     const lines = ['=== OSS igaming platform catalog ==='];
     lines.push(`modules: ${c.modules.length}  adapters: ${c.adapters.length}  events: ${c.events.length}  ` +
-        `uiSlots: ${c.uiSlots.length}  schemas: ${c.schemas.length}  ` +
-        `httpRoutes: ${c.httpRoutes.length}`);
+        `schemas: ${c.schemas.length}  agent tools: ${c.agentTools?.length ?? 0}  ` +
+        `action types: ${c.agentActions?.length ?? 0}`);
     lines.push('\n--- Adapter seams (implement an interface, bind to the token) ---');
     for (const a of c.adapters) {
         lines.push(`- ${a.category}: ${a.interface} -> ${a.token}  [${a.status}]`);
@@ -72,7 +101,7 @@ server.registerTool('catalog-overview', {
     for (const f of c.config.fields) {
         lines.push(`- ${f.key}${f.note ? `: ${f.note}` : ''}`);
     }
-    lines.push('\nNext: list-adapters | list-routes | list-events | list-slots | describe-module <name> | schema-get <name> | get-config-schema');
+    lines.push('\nNext: list-adapters | list-routes | list-events | list-agent-tools | describe-module <name> | schema-get <name> | get-config-schema');
     return lines.join('\n');
 }));
 server.registerTool('list-adapters', {
@@ -97,7 +126,7 @@ server.registerTool('list-adapters', {
     return lines.join('\n');
 }));
 server.registerTool('list-routes', {
-    description: 'List oRPC route namespaces exposed by the platform modules. Pass `module` to scope to a single module. Includes top-level httpRoutes when present.',
+    description: 'List oRPC route namespaces exposed by the platform modules. Pass `module` to scope to a single module.',
     inputSchema: {
         module: z.string().optional().describe('Module id to filter by (e.g. "wallet")'),
     },
@@ -124,9 +153,6 @@ server.registerTool('list-routes', {
             lines.push(`${m.id}:\n${m.routes.map((r) => `  ${r}`).join('\n')}`);
         }
     }
-    if (!mod && c.httpRoutes.length > 0) {
-        lines.push(`httpRoutes:\n${c.httpRoutes.map((r) => `  ${r}`).join('\n')}`);
-    }
     const text = lines.join('\n\n') || 'No routes defined in the catalog yet.';
     return { content: [{ type: 'text', text }] };
 });
@@ -139,19 +165,25 @@ server.registerTool('list-events', {
     }
     return `=== Domain events (${c.events.length}) ===\n${c.events.map((e) => `- ${e}`).join('\n')}`;
 }));
-server.registerTool('list-slots', {
-    description: 'List the named UI slots you can fill from a client-side UI plugin (ctx.<slot>.add(...)) to extend the backoffice without forking: nav items, table columns, dashboard tiles, detail sections. Includes each slot description and subject type.',
-    inputSchema: {},
-}, withCatalog((c) => {
-    if (c.uiSlots.length === 0) {
-        return 'No UI slots in the catalog.';
-    }
-    const lines = ['=== UI slots ==='];
-    for (const s of c.uiSlots) {
-        lines.push(`- ${s.name}${s.description ? `  # ${s.description}` : ''}`);
+server.registerTool('list-agent-tools', {
+    description: 'List the agent surface: MCP tools (read calls a model may make during a run) and action types (state changes a model may only propose; an idempotent executor runs them after approval). Each entry shows its IAM resource:action, schema version and owning module. Modules register them in plugin.ts with ctx.mcp.tool(defineMcpTool({...}), factory) and ctx.actions.register(defineActionType({...}), factory); consumers reach them only through the MCP_KERNEL token, which validates input, checks IAM, applies the output allow-list and audits every call. Pass `module` to scope to one module.',
+    inputSchema: {
+        module: z.string().optional().describe('Module id to filter by (e.g. "wallet")'),
+    },
+}, async ({ module: mod }) => {
+    const loaded = loadCatalog();
+    if (!loaded) {
+        return { content: [{ type: 'text', text: NOT_FOUND_MESSAGE }] };
     }
-    return lines.join('\n');
-}));
+    const c = loaded.catalog;
+    const tools = (c.agentTools ?? []).filter((t) => !mod || t.module === mod);
+    const actions = (c.agentActions ?? []).filter((a) => !mod || a.module === mod);
+    const lines = [`=== Agent tools (${tools.length}) ===`];
+    lines.push(...(tools.length > 0 ? tools.flatMap(formatAgentTool) : ['(none)']));
+    lines.push(`\n=== Agent action types (${actions.length}) ===`);
+    lines.push(...(actions.length > 0 ? actions.flatMap(formatAgentAction) : ['(none)']));
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+});
 server.registerTool('describe-module', {
     description: "Describe one platform module from the catalog: its group (player/backoffice/platform), Drizzle tables, and oRPC routes. Use this to understand a module's surface before extending or integrating with it.",
     inputSchema: { name: z.string().describe('Module id (e.g. "wallet", "gaming")') },
@@ -176,6 +208,14 @@ server.registerTool('describe-module', {
     const lines = [`=== Module: ${m.id} (${m.group}) ===`];
     lines.push(`\n--- Tables ---\n${m.tables.length > 0 ? m.tables.map((t) => `- ${t}`).join('\n') : '(none)'}`);
     lines.push(`\n--- Routes ---\n${m.routes.length > 0 ? m.routes.map((r) => `- ${r}`).join('\n') : '(none)'}`);
+    const tools = (c.agentTools ?? []).filter((t) => t.module === m.id);
+    const actions = (c.agentActions ?? []).filter((a) => a.module === m.id);
+    if (tools.length > 0) {
+        lines.push(`\n--- Agent tools ---\n${tools.flatMap(formatAgentTool).join('\n')}`);
+    }
+    if (actions.length > 0) {
+        lines.push(`\n--- Agent action types ---\n${actions.flatMap(formatAgentAction).join('\n')}`);
+    }
     return { content: [{ type: 'text', text: lines.join('\n') }] };
 });
 server.registerTool('schema-get', {
@@ -220,23 +260,6 @@ server.registerTool('get-config-schema', {
     }
     return lines.join('\n');
 }));
-function classifyIntent(ask) {
-    const a = ` ${ask.toLowerCase()} `;
-    const has = (re) => re.test(a);
-    if (has(/\b(payment|psp|stripe|adyen|kyc|onfido|sms|email|notification|vendor|adapter|gateway)\b/)) {
-        return 'adapter';
-    }
-    if (has(/\b(page|screen|dashboard|view|frontend|admin panel|backoffice page|player page)\b/)) {
-        return 'ui-page';
-    }
-    if (has(/\b(endpoint|route|procedure|api method|rpc)\b/)) {
-        return 'route';
-    }
-    if (has(/\b(feature|module|tournament|leaderboard|jackpot|loyalty|bonus|cashback|mission|reward)\b/)) {
-        return 'feature';
-    }
-    return 'unsure';
-}
 function buildConsumerPlaybook(kind, ctx) {
     const moduleList = ctx.modules.length
         ? ctx.modules.map((m) => `- ${m}`).join('\n')
@@ -245,7 +268,7 @@ function buildConsumerPlaybook(kind, ctx) {
         case 'feature':
             return [
                 '## Where it goes',
-                'New behavior in a consumer repo -> an overlay plugin (`pnpm gen plugin`). It can add routes, subscribe to events, rebind adapters, and fill UI slots without touching OSS core.',
+                'New behavior in a consumer repo -> an overlay plugin (`pnpm gen plugin`). It can add routes, subscribe to events, and rebind adapters without touching OSS core.',
                 'If this is a new business domain that should be in the OSS platform itself, open an issue on the OSS repo instead.',
                 '',
                 '## Existing platform modules you can hook into',
@@ -253,15 +276,15 @@ function buildConsumerPlaybook(kind, ctx) {
                 '',
                 '## Playbook',
                 '1. Spawn the `expert` agent (Task tool) to turn this ask into requirements + acceptance criteria (player journey, jurisdiction rules, edge cases). Skip only for a trivial change.',
-                '2. Spawn the `builder` agent to implement: `pnpm gen plugin`, then in `register(ctx)` add routes (`ctx.routers.add`), subscribe to events (`ctx.events.on`), fill slots (`ctx.slots.fill`).',
+                '2. Spawn the `builder` agent to implement: `pnpm gen plugin`, then in `register(ctx)` add routes (`ctx.routers.add`) and subscribe to events (`ctx.events.on`).',
                 '3. Register the plugin in `extensions.config.ts` at the repo root.',
-                '4. Spawn the `qa` agent to write/run a Playwright E2E test for the acceptance criteria.',
-                '5. Run `pnpm typecheck && pnpm lint`.',
+                '4. Spawn the `tester` agent to write/run a Playwright E2E test for the acceptance criteria.',
+                '5. Run `pnpm check:types && pnpm check:lint`.',
                 '',
                 '## Agents',
                 '- `expert` - requirements + AC (advisory, no code)',
                 '- `builder` - implements the overlay',
-                '- `qa` - E2E test + bug triage (OSS-core vs overlay)',
+                '- `tester` - E2E test + bug triage (OSS-core vs overlay)',
             ].join('\n');
         case 'adapter':
             return [
@@ -277,7 +300,7 @@ function buildConsumerPlaybook(kind, ctx) {
                 '1. If the adapter is compliance-sensitive (KYC/AML, PSP, geo), spawn the `expert` agent first to confirm jurisdiction requirements.',
                 '2. Spawn the `builder` agent to implement: `pnpm gen adapter` (prompts for name + token), implement the interface, bind it in the generated plugin.',
                 '3. Ensure the plugin is listed AFTER the module that owns the default binding in `extensions.config.ts` (last registration wins).',
-                '4. Run `pnpm typecheck && pnpm lint`.',
+                '4. Run `pnpm check:types && pnpm check:lint`.',
                 '',
                 '## Agents',
                 '- `expert` - jurisdiction/compliance requirements (advisory)',
@@ -286,21 +309,16 @@ function buildConsumerPlaybook(kind, ctx) {
         case 'ui-page':
             return [
                 '## Where it goes',
-                'The platform is headless - pages live in your own frontend repo and consume the api via `@openora/core/react`. Fill named UI slots from a client-side UI plugin.',
-                '',
-                '## Named UI slots you can fill (via defineUIPlugin)',
-                ctx.slots.length
-                    ? ctx.slots.map((s) => `- ${s}`).join('\n')
-                    : '- (run list-slots for details)',
+                'The platform is headless - pages live in your own frontend repo and consume the api via `@openora/core/react`.',
                 '',
                 '## Playbook',
-                '1. Spawn the `builder` agent to implement the page in your frontend repo, or extend an existing surface via `defineUIPlugin` into a slot above.',
-                '2. Spawn the `qa` agent to verify the page renders and behaves in a browser.',
-                '3. Run `pnpm typecheck`.',
+                '1. Spawn the `builder` agent to implement the page in your frontend repo.',
+                '2. Spawn the `tester` agent to verify the page renders and behaves in a browser.',
+                '3. Run `pnpm check:types`.',
                 '',
                 '## Agents',
                 '- `builder` - mounts/extends the page',
-                '- `qa` - browser verification',
+                '- `tester` - browser verification',
             ].join('\n');
         case 'route':
             return [
@@ -312,7 +330,7 @@ function buildConsumerPlaybook(kind, ctx) {
                 '',
                 '## Playbook',
                 '1. Spawn the `builder` agent to implement: `pnpm gen plugin` if no overlay exists, then add the oRPC route in `register(ctx)`. Admin routes must assert AdminGuard first.',
-                '2. Run `pnpm typecheck && pnpm lint`.',
+                '2. Run `pnpm check:types && pnpm check:lint`.',
                 '',
                 '## Agents',
                 '- `builder` - implements the route',
@@ -329,7 +347,7 @@ function buildConsumerPlaybook(kind, ctx) {
                 '## Agents available in this repo',
                 '- `expert` - domain/product requirements (advisory)',
                 '- `builder` - fullstack implementation',
-                '- `qa` - E2E testing',
+                '- `tester` - E2E testing',
             ].join('\n');
     }
 }
@@ -365,7 +383,7 @@ const REQUIREMENTS_INTERVIEW = [
     'Then summarize the requirements back to the user as a short structured list and get an explicit yes before any building starts.',
 ].join('\n');
 server.registerTool('enhance-intent', {
-    description: 'Turn a fuzzy "I want to build X" ask into a grounded, consumer-context brief. Uses the platform catalog (live module/adapter/slot list) to return a classified intent, a requirements checklist to collect from the user, a step-by-step playbook using the consumer pnpm gen commands, and an acceptance-criteria stub.',
+    description: 'Turn a fuzzy "I want to build X" ask into a grounded, consumer-context brief. Uses the platform catalog (live module and adapter list) to return a classified intent, a requirements checklist to collect from the user, a step-by-step playbook using the consumer pnpm gen commands, and an acceptance-criteria stub.',
     inputSchema: {
         ask: z
             .string()
@@ -382,7 +400,6 @@ server.registerTool('enhance-intent', {
     const ctx = {
         modules: catalog?.modules.map((m) => `${m.group}/${m.id}`) ?? [],
         tokens: catalog?.adapters.map((a) => a.token) ?? [],
-        slots: catalog?.uiSlots.map((s) => s.name) ?? [],
     };
     const detected = kind && kind !== 'unsure' ? '' : ' (auto-detected)';
     const text = [
@@ -403,7 +420,7 @@ server.registerTool('enhance-intent', {
         '## Acceptance criteria (derive from the requirements above)',
         '- [ ] Happy path works end to end',
         '- [ ] Edge cases handled',
-        '- [ ] `pnpm typecheck && pnpm lint` is green',
+        '- [ ] `pnpm check:types && pnpm check:lint` is green',
     ].join('\n');
     return { content: [{ type: 'text', text }] };
 });
@@ -422,14 +439,13 @@ server.registerTool('start', {
     const tokens = catalog?.adapters.map((a) => a.token) ?? [];
     const role = [
         '## Your role',
-        'You are a requirements interviewer and orchestrator, NOT the implementer. Your one human-facing job is to collect thorough requirements from the user. Everything after that - scaffolding, code, tests - you delegate to the agents (`expert`, `builder`, `qa`) via the Task tool. Keep the user out of the loop after requirements are confirmed, except to resolve genuine decisions only they can make.',
+        'You are a requirements interviewer and orchestrator, NOT the implementer. Your one human-facing job is to collect thorough requirements from the user. Everything after that - scaffolding, code, tests - you delegate to the agents (`expert`, `builder`, `tester`) via the Task tool. Keep the user out of the loop after requirements are confirmed, except to resolve genuine decisions only they can make.',
     ].join('\n');
     if (ask) {
         const resolved = classifyIntent(ask);
         const playbook = buildConsumerPlaybook(resolved, {
             modules,
             tokens,
-            slots: catalog?.uiSlots.map((s) => s.name) ?? [],
         });
         return {
             content: [
@@ -480,15 +496,95 @@ server.registerTool('start', {
                     'Call `enhance-intent` (ask = the confirmed requirements summary, kind = step 1). Then follow its playbook, which delegates to the agents:',
                     '- `expert` formalizes requirements + acceptance criteria (and may surface gaps - if so, ask the user those, then continue).',
                     '- `builder` implements (`pnpm gen ...`, code).',
-                    '- `qa` writes/runs the E2E test.',
+                    '- `tester` writes/runs the E2E test.',
                     'You orchestrate; you do not write feature code yourself.',
                     '',
-                    `Platform modules: ${modules.join(', ') || '(catalog not loaded - run pnpm build:oss first)'}`,
+                    `Platform modules: ${modules.join(', ') || '(catalog not loaded)'}`,
                 ].join('\n'),
             },
         ],
     };
 });
+let builtGraph = null;
+// The repo's own graph: a prebuilt dep-graph.json at the root wins (CI writes one), else built
+// once per server process - a full cruise takes seconds, not milliseconds.
+function localGraph(rebuild) {
+    const prebuilt = join(process.cwd(), 'dep-graph.json');
+    if (!rebuild && existsSync(prebuilt)) {
+        return JSON.parse(readFileSync(prebuilt, 'utf8'));
+    }
+    if (rebuild || !builtGraph) {
+        builtGraph = buildDepGraph(process.cwd());
+    }
+    return builtGraph;
+}
+// Shipped with the package (built by the platform's publish job), so a consumer repo can follow
+// a platform file into its own code without a platform checkout.
+function platformGraph() {
+    const shipped = join(here, '..', 'docs', 'dep-graph.json');
+    return existsSync(shipped) ? JSON.parse(readFileSync(shipped, 'utf8')) : null;
+}
+server.registerTool('impact', {
+    description: 'Blast radius of a change: for each repo-relative file, the files that import it (transitively), and for a platform file (packages/core/src/...) the public @openora/* entry points it reaches plus the consumer files importing them. Use before editing a shared file, or to decide what to re-test after a change.',
+    inputSchema: {
+        files: z
+            .array(z.string())
+            .min(1)
+            .describe('Repo-relative paths, e.g. "apps/web/src/lib/x.ts"'),
+        depth: z
+            .number()
+            .int()
+            .min(1)
+            .max(10)
+            .optional()
+            .describe('Import hops to follow (default 4)'),
+        rebuild: z
+            .boolean()
+            .optional()
+            .describe('Re-cruise the repo instead of using a cached graph'),
+    },
+}, async ({ files, depth = 4, rebuild = false }) => {
+    let local;
+    try {
+        local = localGraph(rebuild);
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Could not build the graph: ${String(error)}` }],
+        };
+    }
+    const platform = platformGraph();
+    const list = (items, max = 40) => items.length === 0
+        ? '  (none)'
+        : items
+            .slice(0, max)
+            .map((i) => `  - ${i}`)
+            .join('\n') + (items.length > max ? `\n  (+${items.length - max} more)` : '');
+    const sections = files.map((file) => {
+        const known = (g) => file in g.dependents || file in g.entryPoints || file in g.platform;
+        const onPlatform = platform && !known(local) && known(platform);
+        const impact = onPlatform
+            ? impactOf(platform, file, depth, local)
+            : impactOf(local, file, depth);
+        const lines = [
+            `=== ${file} ===`,
+            `Importers (${impact.importers.length}):`,
+            list(impact.importers),
+        ];
+        if (impact.specifiers.length > 0) {
+            lines.push(`Public entry points reached:`, list(impact.specifiers));
+        }
+        if (onPlatform) {
+            lines.push(`Files in this repo importing them:`, list(impact.consumerFiles));
+        }
+        const imports = local.platform[file];
+        if (imports?.length) {
+            lines.push(`Platform imports of this file:`, list(imports));
+        }
+        return lines.join('\n');
+    });
+    return { content: [{ type: 'text', text: sections.join('\n\n') }] };
+});
 server.registerTool('dev:infra', {
     description: 'Start / stop / status local dev infrastructure via docker compose (postgres on :5432). Call before pnpm db:migrate or pnpm dev when the database is not reachable.',
     inputSchema: {