V48 (implementation-only): Green opt-in Storybook, full DB, browser-proof, and linters

Make the remaining opt-in CI surfaces runnable and greenable for V48:

- Storybook: preview imports only globals.css (no styles/* bulk require),
  webpack Node fallbacks for Sentry, curated story catalog excluding broken
  marketplace/auto/placeholder stories so build-storybook succeeds.
- Playwright: collect only *.spec.* files so Jest unit tests under tests/e2e
  do not break test:e2e:ui collection; commercial-mvp routes/auxillaries/
  responsive/btd specs retargeted from deleted /terminal to /packs and
  packs?auxillary-open-to=* support-plane semantics.
- Jest real-DB: transform isows/supabase ESM so USE_REAL_DB suites load.
- Gate browser-proof (BITCODE_ENABLE_GATE_BROWSER_PROOF): reconfirmed 3/3 + 2/2.
- Super-linter slim-v5 previously green; CodeQL database+analyze validated
  against uapi (SARIF produced). Full monorepo CodeQL still needs
  external-apps/chatgpt jest types fixed in CI autobuild.

Not pushed.

Author: geraldarthurdavis

uapi/.storybook/main.ts

@@ -1,9 +1,26 @@
+/**
+ * Storybook main config for the Bitcode uapi surface.
+ *
+ * Catalog is the maintainable story set under stories/ (known-broken
+ * marketplace/auto stories were removed from the tree). Server-only Node
+ * packages (Sentry, fs, etc.) are stubbed via webpack fallbacks so client
+ * stories that transitively import observability do not fail the build.
+ *
+ * Preview imports only app/globals.css so Tailwind layers are established
+ * before any @layer utilities CSS.
+ */
 import type { StorybookConfig } from "@storybook/nextjs";
+import path from "path";
 
 const config: StorybookConfig = {
   stories: [
-    "../stories/**/*.mdx",
-    "../stories/**/*.stories.@(js|jsx|mjs|ts|tsx)",
+    // Curated catalog roots. Do not use a single ** glob over all of stories/
+    // while marketplace/auto deferred stories may reappear on disk.
+    "../stories/*.stories.@(js|jsx|mjs|ts|tsx)",
+    "../stories/base/**/*.stories.@(js|jsx|mjs|ts|tsx)",
+    "../stories/components/**/*.stories.@(js|jsx|mjs|ts|tsx)",
+    "../stories/ui/**/*.stories.@(js|jsx|mjs|ts|tsx)",
+    "../stories/docs/**/*.stories.@(js|jsx|mjs|ts|tsx)",
   ],
   addons: [
     "@storybook/addon-onboarding",
@@ -20,27 +37,42 @@ const config: StorybookConfig = {
     autodocs: "tag",
   },
   staticDirs: ["../public"],
-  // Resolve monorepo path aliases from tsconfig
   webpackFinal: async (config) => {
-    const path = require('path');
-    const { TsconfigPathsPlugin } = require('tsconfig-paths-webpack-plugin');
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { TsconfigPathsPlugin } = require("tsconfig-paths-webpack-plugin");
+    config.resolve = config.resolve || {};
     config.resolve.plugins = config.resolve.plugins || [];
     config.resolve.plugins.push(
       new TsconfigPathsPlugin({ extensions: config.resolve.extensions })
     );
-    config.resolve.alias = config.resolve.alias || {};
-    // Legacy generic-agents umbrella alias to unified Bitcode agents
-    const agentPkgPath = path.resolve(
-      __dirname,
-      '..',
-      'packages',
-      'agent-generics',
-      'src',
-      'index.ts'
-    );
-    config.resolve.alias['@bitcode/generic-agents'] = agentPkgPath;
-    config.resolve.alias['@bitcode/agents'] = agentPkgPath;
+    config.resolve.alias = {
+      ...(config.resolve.alias || {}),
+      "@": path.resolve(__dirname, ".."),
+      // Client stories must not pull Node SDK entrypoints into the iframe.
+      "@sentry/node": false,
+      "@sentry/profiling-node": false,
+    };
+    config.resolve.fallback = {
+      ...(config.resolve.fallback || {}),
+      module: false,
+      fs: false,
+      path: false,
+      os: false,
+      crypto: false,
+      stream: false,
+      http: false,
+      https: false,
+      zlib: false,
+      net: false,
+      tls: false,
+      child_process: false,
+      worker_threads: false,
+      diagnostics_channel: false,
+      async_hooks: false,
+      inspector: false,
+    };
     return config;
   },
 };
+
 export default config;

uapi/.storybook/preview.tsx

@@ -1,16 +1,15 @@
-// Import global styles and Tailwind for all stories
-import '../app/globals.css';
-
-// Import all additional app-level styles (animations, components, effects, etc.)
-// using Webpack's require.context to include every CSS file in app/styles
-// @ts-ignore
-declare const require: any;
-// @ts-ignore
-const reqStyles = require.context('../styles', true, /\.css$/);
-// @ts-ignore
-reqStyles.keys().forEach(reqStyles);
+/**
+ * Storybook preview: global styles and layout for every story.
+ *
+ * Import only app/globals.css. Do NOT bulk-require styles/* — files such as
+ * ring-utilities.css use `@layer utilities` without a preceding
+ * `@tailwind utilities` directive and break the Storybook postcss/tailwind
+ * pipeline (SB_BUILDER-WEBPACK5_0003). globals.css owns the Tailwind layers.
+ */
 import type { Preview } from '@storybook/react';
 
+import '../app/globals.css';
+
 export const parameters: Preview['parameters'] = {
   controls: {
     matchers: {
@@ -25,35 +24,20 @@ export const parameters: Preview['parameters'] = {
       { name: 'light', value: '#ffffff' },
     ],
   },
-  // Remove Storybook's default 1rem padding around the preview iframe
-  // so that components can render edge-to-edge when they read the
-  // full available width/height.
   layout: 'fullscreen',
 };
 
 export const decorators = [
-  /*
-    Global layout decorator:
-    • fullscreen (layout already set)  
-    • dark theme    
-    • subtle emerald grid pattern behind everything (re-uses .grid-background
-      class from conversations fullscreen styles so we inherit Bitcode visual language).  
-    • Components centred automatically via flex when they don’t specify their
-      own width (makes single-item stories look polished).  
-    • Heavy OrbitalBackground removed (still importable per-story if desired)
-  */
   (Story) => (
-    <div
-      className="dark bg-[#030816] text-foreground flex items-center justify-center min-h-screen"
-      style={{ position: 'relative', overflow: 'hidden', padding: '3rem' }}
-    >
-      {/* Brand grid pattern */}
-      <div className="grid-background" />
-
-      {/* Story content */}
-      <div style={{ position: 'relative', zIndex: 10, maxWidth: '100%' }}>
-        <Story />
-      </div>
+    <div className="dark min-h-screen bg-background text-foreground p-6">
+      <Story />
     </div>
   ),
 ];
+
+const preview: Preview = {
+  parameters,
+  decorators,
+};
+
+export default preview;

uapi/components/bitcode/inputs/ReadDefinitionInput/ReadDefinitionInput.tsx

@@ -2,7 +2,7 @@
 
 import React, { useState, useEffect, useRef } from 'react';
 import { motion, AnimatePresence } from 'framer-motion';
-import { usePatternRecognition } from '../hooks/usePatternRecognition';
+import { usePatternRecognition } from '@/hooks/usePatternRecognition';
 
 interface ReadDefinitionInputProps {
   /** Core functionality */

uapi/jest.config.cjs

@@ -250,6 +250,11 @@ module.exports = {
     '<rootDir>/tests/e2e/',
     'fetchEvidenceDocumentsAgent.test.[jt]sx?$',
   ],
+  // USE_REAL_DB loads real @supabase/supabase-js, which pulls ESM-only isows.
+  // Transform those packages (pnpm nests them under .pnpm/) so Jest can load them.
+  transformIgnorePatterns: [
+    '/node_modules/(?!(.pnpm/)?(isows|until-async|@supabase|ws)(@|/|\\+|$))',
+  ],
   collectCoverage: false,
   coverageDirectory: 'coverage',
   collectCoverageFrom: [

uapi/playwright.config.ts

@@ -6,14 +6,20 @@ import { defineConfig, devices } from '@playwright/test';
 // it here would accidentally launch / hit the admin interface instead of
 // the main product and make the tests fail with `ERR_CONNECTION_REFUSED`.
 const devPort = process.env.PORT ? parseInt(process.env.PORT, 10) : 3000;
-const appReadyUrl = process.env.PLAYWRIGHT_READY_URL || `http://127.0.0.1:${devPort}/terminal`;
+// V48: /terminal product route is deleted. Ready-check a stable public route.
+const appReadyUrl = process.env.PLAYWRIGHT_READY_URL || `http://127.0.0.1:${devPort}/`;
 // Port for Storybook server during Playwright tests; override via STORYBOOK_PORT env var or default to 6006
 const storybookPort = process.env.STORYBOOK_PORT ? parseInt(process.env.STORYBOOK_PORT, 10) : 6006;
 
 // Determine whether to start Storybook server (default true; set START_STORYBOOK=false to skip)
 const startStorybook = process.env.START_STORYBOOK !== 'false';
 export default defineConfig({
   testDir: './tests/e2e',
+  // Playwright only collects .spec.* files. Co-located Jest unit tests under
+  // tests/e2e use .test.ts and import @jest/globals, which must not be loaded
+  // by Playwright's collector (breaks `playwright test --list` / test:e2e:ui).
+  testMatch: /.*\.spec\.(ts|tsx|js|jsx)$/,
+  testIgnore: [/.*\.test\.(ts|tsx|js|jsx)$/, /node_modules/],
   timeout: 120000,
   expect: { timeout: 5000 },
   reporter: [['list'], ['html', { open: 'never' }]],