feat(workspace): Report Editor Workspace Phases 0–6 + demo pages (Droid-assisted)

.gitignore

@@ -7,11 +7,16 @@ dist/
 build/
 .vite/
 
+# Generated media
+public/audio/
+public/podcasts/
+
 # Environment variables
 .env
 .env.local
 .env.production
 .env.development
+.env.procore
 
 # IDE
 .vscode/

CLAUDE.md

@@ -0,0 +1,61 @@
+# CLAUDE.md - PlexifyBID Repository Rules
+
+## Who I Am
+Ken, solo founder of Plexify AI. I coordinate development across:
+- Claude Sonnet: Strategy, specs, prompts
+- Code Droid (Factory.ai): Frontend implementation
+- Claude Code: Backend development, architecture
+- GitHub Desktop + VSCode: Local development
+
+## Repository Architecture
+This is NOT a traditional frontend/backend split. The app runs as React + Vite with backend middleware embedded in Vite's dev server.
+
+### Backend Routes (Vite middleware):
+- /api/agents/<id> — Claude-powered analysis
+- /api/tts/generate — OpenAI text-to-speech
+- /api/podcast/generate — ElevenLabs synthesis
+- /api/export/docx — Word document export
+
+## Current State
+- Stable tag: v0.1.0-demo-ready
+- Active branch: develop
+- Backend readiness: ~40% (works for demos, not production)
+- Known gaps: No database, no auth, no rate limiting, no tests
+
+## Safety Rules (NON-NEGOTIABLE)
+
+### Before ANY code changes:
+1. State what you intend to change and why
+2. Wait for my explicit approval
+3. Never force push, never delete branches
+
+### Branch discipline:
+- Feature work: feature/[description]
+- Backups before risky ops: backup/[description]-[date]
+- PRs required for merging to develop
+
+### NEVER do:
+- Delete functionality without approval
+- Modify .env files or commit secrets
+- Push directly to develop or main
+- Run destructive operations
+- Install packages without stating why
+
+## Known Technical Debt (Don't Fix Without Asking)
+- @ts-nocheck in App.tsx — needs careful migration
+- 85+ console.log statements — cleanup later
+- as any casts — address incrementally
+- Backup files in repo — cleanup later
+
+## Current Priorities
+1. Backend stability for pilot demos
+2. NotebookBD RAG pipeline reliability
+3. API error handling improvements
+4. Security hardening (auth, rate limiting)
+
+## Communication Style
+- Be direct, not verbose
+- Tables for comparisons
+- Never use: delve, leverage, seamless, transformative
+- Hit a blocker? Tell me immediately
+- Uncertain? Propose 2-3 options, let me choose

TROUBLESHOOTING.md

@@ -0,0 +1,57 @@
+# Troubleshooting
+
+## `Invalid hook call` when consuming `plexify-shared-ui`
+
+**Symptom**
+
+- Workspace (or other shared-ui components) white-screens and the console shows:
+  - `Invalid hook call. Hooks can only be called inside of the body of a function component...`
+  - Often followed by `Cannot read properties of null (reading 'useMemo')` coming from `@dnd-kit/*` hooks.
+
+**Cause**
+
+This almost always means the app has **multiple copies of React** (and/or hook-based dependencies like `@dnd-kit/*`) loaded at runtime.
+
+This is easy to trigger during local development when `plexify-shared-ui` is linked via `file:../plexify-shared-ui` and that linked folder contains its own `node_modules`.
+
+**Fix (Vite)**
+
+In the consuming app's `vite.config.ts`, ensure Vite dedupes these packages so a single instance is used:
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import { resolve } from 'path';
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    dedupe: [
+      'react',
+      'react-dom',
+      'react/jsx-runtime',
+      'react/jsx-dev-runtime',
+      '@dnd-kit/core',
+      '@dnd-kit/sortable',
+      '@dnd-kit/utilities',
+      'zustand',
+      '@tiptap/react',
+      '@tiptap/starter-kit',
+    ],
+
+    // If you are using a linked `../plexify-shared-ui` that has its own node_modules,
+    // aliases are the most reliable way to force a single instance.
+    alias: {
+      react: resolve(__dirname, 'node_modules/react'),
+      'react-dom': resolve(__dirname, 'node_modules/react-dom'),
+      'react/jsx-runtime': resolve(__dirname, 'node_modules/react/jsx-runtime.js'),
+      'react/jsx-dev-runtime': resolve(__dirname, 'node_modules/react/jsx-dev-runtime.js'),
+    },
+  },
+});
+```
+
+**Also recommended**
+
+- If you're linking locally, consider removing `../plexify-shared-ui/node_modules` (or avoid installing React there) so React is only resolved from the consuming app.

docs/DEV_WORKFLOW.md

@@ -0,0 +1,85 @@
+# PlexifyBID Development Workflow
+
+## AI-Assisted Development Stack
+
+| Tool | Role | When to Use |
+|------|------|-------------|
+| Claude Sonnet | Strategy, specs, prompts | Planning sessions, PRD work |
+| Code Droid (Factory.ai) | Frontend implementation | UI components, React work |
+| Claude Code | Backend development | API endpoints, middleware, architecture |
+| GitHub Desktop + VSCode | Local development | Manual edits, debugging, git operations |
+
+## Claude Code Workflow
+
+### Before Starting
+1. Pull latest from develop
+2. Confirm CLAUDE.md is present at repo root
+3. Claude Code will read CLAUDE.md and follow its rules
+
+### The Edit Cycle
+branch → spec → review proposal → approve edits → test → PR
+
+**Step 1: Create Feature Branch**
+Create a new branch called feature/[description] from develop
+
+**Step 2: Give a Clear Spec**
+Include:
+- What the feature should do
+- Expected inputs/outputs
+- Any patterns to follow
+- End with: "Show me the approach before making changes"
+
+**Step 3: Review Proposal**
+Claude Code should:
+- Explore existing code first
+- Propose where changes will go
+- Show code before writing
+- Wait for explicit approval
+
+If it skips this, say:
+Stop. Show me the change before making it. That's in CLAUDE.md.
+
+**Step 4: Approve Edits**
+- Review each file change
+- Choose "Yes" for single edit approval
+- Only use "Yes to all" for trusted, low-risk sessions
+
+**Step 5: Test Locally**
+npm run dev
+Verify the feature works before pushing.
+
+**Step 6: Push and PR**
+Push this branch and create a PR to merge into develop
+
+## Commit Message Convention
+
+Format: `[type]: brief description`
+
+| Type | Use For |
+|------|---------|
+| feat | New feature |
+| fix | Bug fix |
+| refactor | Code restructure, no behavior change |
+| docs | Documentation only |
+| chore | Maintenance, dependencies |
+
+Examples:
+- `feat: add /api/health endpoint`
+- `fix(security): add .env.procore to gitignore`
+- `docs: add DEV_WORKFLOW.md`
+
+## Safety Rules (from CLAUDE.md)
+
+- Always work on feature branches
+- Never push directly to develop or main
+- Create backup branches before risky operations
+- PRs required for merging
+- No destructive operations without explicit approval
+
+## Testing Checklist
+
+Before creating a PR:
+- [ ] Feature works locally
+- [ ] No console errors
+- [ ] Existing features still work
+- [ ] Commit messages follow convention

package.json

@@ -1,52 +1,79 @@
 {
-  "name": "plexifybid",
-  "version": "1.0.0",
-  "main": "index.js",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "preview": "vite preview",
-    "test": "echo \"No tests yet\""
-  },
-  "keywords": ["BID", "business-improvement-district", "operations", "management"],
-  "author": "Ken D'Amato <ken@plexify.io>",
-  "license": "MIT",
-  "description": "PlexifyBID - Operations Management Platform for Business Improvement Districts",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Plexify-AI/plexifybid.git"
-  },
-  "dependencies": {
-    "@types/react": "^19.1.13",
-    "@types/react-dom": "^19.1.9",
-    "@types/uuid": "^10.0.0",
-    "@vitejs/plugin-react": "^5.0.3",
-    "autoprefixer": "^10.4.21",
-    "axios": "^1.12.2",
-    "cors": "^2.8.5",
-    "crypto-js": "^4.2.0",
-    "dotenv": "^17.2.3",
-    "express": "^5.1.0",
-    "express-rate-limit": "^8.1.0",
-    "helmet": "^8.1.0",
-    "js-cookie": "^3.0.5",
-    "lucide-react": "^0.544.0",
-    "node-fetch": "^3.3.2",
-    "pdf-parse": "^2.2.2",
-    "postcss": "^8.5.6",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
-    "react-router-dom": "^7.9.1",
-    "tailwindcss": "^3.4.17",
-    "typescript": "^5.9.2",
-    "uuid": "^13.0.0",
-    "vite": "^7.1.6",
-    "zustand": "^5.0.8"
-  },
-  "devDependencies": {
-    "@types/cors": "^2.8.19",
-    "@types/express": "^5.0.3",
-    "@types/js-cookie": "^3.0.6",
-    "@types/node": "^24.7.0"
-  }
+    "name": "plexifybid",
+    "version": "1.0.0",
+    "main": "index.js",
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build",
+        "preview": "vite preview",
+        "assets:check": "node scripts/assets-check.mjs",
+        "assets:fix": "node scripts/assets-check.mjs --fix",
+        "test": "echo \"No tests yet\"",
+        "type-check": "tsc -p tsconfig.typecheck.json --noEmit"
+    },
+    "keywords": [
+        "BID",
+        "business-improvement-district",
+        "operations",
+        "management"
+    ],
+    "author": "Ken D'Amato <ken@plexify.io>",
+    "license": "MIT",
+    "description": "PlexifyBID - Operations Management Platform for Business Improvement Districts",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/Plexify-AI/plexifybid.git"
+    },
+    "dependencies": {
+        "@dnd-kit/core": "^6.3.1",
+        "@dnd-kit/sortable": "^8.0.0",
+        "@dnd-kit/utilities": "^3.2.2",
+        "@elevenlabs/elevenlabs-js": "^2.28.0",
+        "@tiptap/extension-highlight": "^2.1.0",
+        "@tiptap/extension-placeholder": "^2.1.0",
+        "@tiptap/extension-text-align": "^2.1.0",
+        "@tiptap/extension-underline": "^2.1.0",
+        "@tiptap/react": "^2.1.0",
+        "@tiptap/starter-kit": "^2.1.0",
+        "@types/react": "^19.1.13",
+        "@types/react-dom": "^19.1.9",
+        "@types/uuid": "^10.0.0",
+        "@vitejs/plugin-react": "^4.2.1",
+        "autoprefixer": "^10.4.21",
+        "axios": "^1.12.2",
+        "cors": "^2.8.5",
+        "crypto-js": "^4.2.0",
+        "docx": "^9.5.1",
+        "dotenv": "^17.2.3",
+        "express": "^5.1.0",
+        "express-rate-limit": "^8.1.0",
+        "file-saver": "^2.0.5",
+        "helmet": "^8.1.0",
+        "js-cookie": "^3.0.5",
+        "lucide-react": "^0.544.0",
+        "node-fetch": "^3.3.2",
+        "openai": "^6.15.0",
+        "pdf-parse": "1.1.1",
+        "plexify-shared-ui": "file:./plexify-shared-ui",
+        "plyr": "^3.8.4",
+        "postcss": "^8.5.6",
+        "react": "^19.1.1",
+        "react-dom": "^19.1.1",
+        "react-h5-audio-player": "^3.10.1",
+        "react-router-dom": "^7.9.1",
+        "tailwindcss": "^3.4.17",
+        "typescript": "^5.9.2",
+        "uuid": "^13.0.0",
+        "vite": "^5.4.11",
+        "zustand": "^4.5.7"
+    },
+    "devDependencies": {
+        "@types/cors": "^2.8.19",
+        "@types/express": "^5.0.3",
+        "@types/file-saver": "^2.0.7",
+        "@types/js-cookie": "^3.0.6",
+        "@types/node": "^24.7.0",
+        "@types/pdf-parse": "^1.1.5",
+        "svgo": "^3.3.2"
+    }
 }

plexify-shared-ui/.gitignore

@@ -0,0 +1,11 @@
+node_modules
+dist
+*.log
+.DS_Store
+.env
+.env.local
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*