build(web-shared): stop resolving @/ into packages/web-shared

`@/*` now maps only to the consumer's own src in apps/web, apps/ai-gateway,
packages/trpc, the web Jest config and the Storybook alias. Inside
packages/web-shared, `@/*` maps to apps/web/src for tests that use apps/web
helpers; tsconfig.lib.json drops it so runtime code cannot use `@/` at all.

The trpc rollup resolver and the MCP catalog import resolver follow
`@kilocode/web-shared/*` into packages/web-shared/src.

Author: chrarnoldus

apps/ai-gateway/tsconfig.json

@@ -9,7 +9,7 @@
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
     "paths": {
-      "@/*": ["./src/*", "../../packages/web-shared/src/*"],
+      "@/*": ["./src/*"],
       "@kilocode/web-shared/*": ["../../packages/web-shared/src/*"],
       "@kilocode/db": ["../../packages/db/src/index.ts"],
       "@kilocode/db/*": ["../../packages/db/src/*"],

apps/storybook/.storybook/main.ts

@@ -42,7 +42,7 @@ const config: StorybookConfig = {
     if (config.resolve) {
       config.resolve.alias = {
         ...config.resolve.alias,
-        '@': [srcDir, webSharedSrcDir],
+        '@': srcDir,
         '@kilocode/web-shared': webSharedSrcDir,
         '@/lib/utils': resolve(mocksDir, 'utils.ts'),
       };

apps/web/jest.config.ts

@@ -33,7 +33,7 @@ const config: Config = {
     '^@kilocode/app-shared/(.*)$': '<rootDir>/../../packages/app-shared/src/$1',
     '^@kilocode/web-shared/(.*)$': '<rootDir>/../../packages/web-shared/src/$1',
     '^(\\.{1,2}/.+)\\.js$': '$1',
-    '^@/(.*)$': ['<rootDir>/src/$1', '<rootDir>/../../packages/web-shared/src/$1'],
+    '^@/(.*)$': '<rootDir>/src/$1',
     '^server-only$': '<rootDir>/src/tests/setup/__mocks__/server-only.js',
   },
   roots: ['<rootDir>', '<rootDir>/../../packages/web-shared'],

apps/web/src/scripts/mcp-catalog/catalog.ts

@@ -417,6 +417,8 @@ export function buildCatalogJson(rows: CatalogRow[]): string {
 
 const SCRIPTS_DIR = join(__dirname, '..'); // apps/web/src/scripts
 const SRC_DIR = join(SCRIPTS_DIR, '..'); // apps/web/src
+const WEB_SHARED_SPECIFIER_PREFIX = '@kilocode/web-shared/';
+const WEB_SHARED_SRC_DIR = join(REPO_ROOT, 'packages', 'web-shared', 'src');
 
 type RouterFileMap = Map<string, string>; // top-level segment → absolute router file path
 
@@ -425,6 +427,8 @@ function resolveImportSpecifier(specifier: string, fromDir: string): string | nu
   let candidate: string;
   if (withoutQuery.startsWith('@/')) {
     candidate = join(SRC_DIR, withoutQuery.slice(2));
+  } else if (withoutQuery.startsWith(WEB_SHARED_SPECIFIER_PREFIX)) {
+    candidate = join(WEB_SHARED_SRC_DIR, withoutQuery.slice(WEB_SHARED_SPECIFIER_PREFIX.length));
   } else if (withoutQuery.startsWith('./') || withoutQuery.startsWith('../')) {
     candidate = resolve(fromDir, withoutQuery);
   } else {

apps/web/tsconfig.json

@@ -9,7 +9,7 @@
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
     "paths": {
-      "@/*": ["./src/*", "../../packages/web-shared/src/*"],
+      "@/*": ["./src/*"],
       "@kilocode/web-shared/*": ["../../packages/web-shared/src/*"],
       "@kilocode/db": ["../../packages/db/src/index.ts"],
       "@kilocode/db/*": ["../../packages/db/src/*"],

apps/web/tsconfig.scripts.json

@@ -3,7 +3,7 @@
   "compilerOptions": {
     "baseUrl": ".",
     "paths": {
-      "@/*": ["./src/*", "../../packages/web-shared/src/*"],
+      "@/*": ["./src/*"],
       "@kilocode/web-shared/*": ["../../packages/web-shared/src/*"],
       "@kilocode/db": ["../../packages/db/src/index.ts"],
       "@kilocode/db/*": ["../../packages/db/src/*"],

packages/trpc/rollup.config.mjs

@@ -36,12 +36,9 @@ const plugins = [
   {
     name: 'resolve-aliases',
     resolveId(source) {
-      // Resolve @/* path aliases to the tsc output, mirroring the tsconfig
-      // fallback from apps/web/src to packages/web-shared/src.
+      // Resolve the tsconfig path aliases to the tsc output.
       if (source.startsWith('@/')) {
-        const webDts = resolveDts(path.resolve(tscOut, 'apps/web/src', source.slice(2)));
-        if (existsSync(webDts)) return webDts;
-        return resolveDts(path.resolve(tscOut, 'packages/web-shared/src', source.slice(2)));
+        return resolveDts(path.resolve(tscOut, 'apps/web/src', source.slice(2)));
       }
       if (source.startsWith(webSharedPrefix)) {
         const subpath = source.slice(webSharedPrefix.length);

packages/trpc/tsconfig.json

@@ -16,7 +16,7 @@
     "jsx": "react-jsx",
     "resolveJsonModule": true,
     "paths": {
-      "@/*": ["../../apps/web/src/*", "../web-shared/src/*"],
+      "@/*": ["../../apps/web/src/*"],
       "@kilocode/web-shared/*": ["../web-shared/src/*"],
       "@kilocode/db": ["../db/src/index.ts"],
       "@kilocode/db/*": ["../db/src/*"],

packages/web-shared/tsconfig.json

@@ -9,7 +9,7 @@
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
     "paths": {
-      "@/*": ["./src/*", "../../apps/web/src/*"],
+      "@/*": ["../../apps/web/src/*"],
       "@kilocode/web-shared/*": ["./src/*"],
       "@kilocode/db": ["../db/src/index.ts"],
       "@kilocode/db/*": ["../db/src/*"],

packages/web-shared/tsconfig.lib.json

@@ -3,7 +3,6 @@
   "compilerOptions": {
     "types": ["node"],
     "paths": {
-      "@/*": ["./src/*"],
       "@kilocode/web-shared/*": ["./src/*"],
       "@kilocode/db": ["../db/src/index.ts"],
       "@kilocode/db/*": ["../db/src/*"],