@beastmode-develeap/beastmode 0.1.296 → 0.1.298

package/dist/web/board.html

@@ -15,7 +15,7 @@
 }
 </script>
 <!--BOARD_DATA-->
-<script>window.__BUILD_STAMP__ = "20260517-095752-9b7919f";</script>
+<script>window.__BUILD_STAMP__ = "20260517-110542-fd318ea";</script>
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
@@ -8589,6 +8589,122 @@ function EnvironmentPanel({ projectName }) {
   `;
 }
 
+// ================================================================
+// Codebase Guide Panel — surfaced per project on the Projects page
+// ================================================================
+
+function CodebaseGuidePanel({ projectName }) {
+  const [status, setStatus] = useState('idle');
+  const [guideContent, setGuideContent] = useState(null);
+  const [expanded, setExpanded] = useState(false);
+  const [error, setError] = useState(null);
+
+  const fetchStatus = useCallback(async () => {
+    try {
+      const data = await api('GET', '/api/projects/' + projectName + '/analyze/status');
+      const next = (data && data.status) ? data.status : 'idle';
+      setStatus(next);
+      return next;
+    } catch (e) {
+      setStatus('idle');
+      return 'idle';
+    }
+  }, [projectName]);
+
+  const fetchGuide = useCallback(async () => {
+    try {
+      const data = await api('GET', '/api/projects/' + projectName + '/codebase-guide?level=l1');
+      let content = (data && (data.content || data.guide || data.l1)) || '';
+      if (typeof data === 'string') content = data;
+      if (content && content.startsWith('# ')) {
+        const nl = content.indexOf('\n');
+        content = nl >= 0 ? content.slice(nl + 1).replace(/^\s*\n/, '') : '';
+      }
+      setGuideContent(content || '');
+    } catch (e) {
+      if (e && /404/.test(String(e.message || ''))) {
+        setGuideContent('Guide not available');
+      } else {
+        setGuideContent(null);
+      }
+    }
+  }, [projectName]);
+
+  useEffect(() => { fetchStatus(); }, [fetchStatus]);
+
+  useEffect(() => {
+    if (status === 'complete' || status === 'cached') {
+      fetchGuide();
+    }
+  }, [status, fetchGuide]);
+
+  useEffect(() => {
+    if (status !== 'running') return undefined;
+    const id = setInterval(() => { fetchStatus(); }, 3000);
+    return () => clearInterval(id);
+  }, [status, fetchStatus]);
+
+  const reanalyze = async () => {
+    try {
+      setError(null);
+      setGuideContent(null);
+      setExpanded(false);
+      await api('POST', '/api/projects/' + projectName + '/analyze?force=true', {});
+      setStatus('running');
+    } catch (e) {
+      setError(e.message);
+    }
+  };
+
+  const pillLabel =
+    status === 'complete' ? '✓ Analyzed'
+    : status === 'cached' ? '✓ Analyzed'
+    : status === 'running' ? '⏳ Analyzing…'
+    : status === 'failed' ? '✗ Failed'
+    : '—';
+  const pillBg =
+    (status === 'complete' || status === 'cached') ? 'var(--success)'
+    : status === 'running' ? 'var(--warning)'
+    : status === 'failed' ? 'var(--danger)'
+    : 'var(--muted)';
+  const pillStyle = 'display:inline-block;padding:2px 8px;border-radius:10px;background:' + pillBg + ';color:white;font-size:11px;font-weight:600;';
+
+  const canShowContent = (status === 'complete' || status === 'cached');
+  const canReanalyze = (status === 'complete' || status === 'cached' || status === 'failed');
+
+  return html`
+    <div class="ext-item"
+         data-testid=${'codebase-guide-panel-' + projectName}
+         style="flex-basis:100%;flex-direction:column;align-items:stretch;gap:8px;">
+      <div style="display:flex;align-items:center;justify-content:space-between;gap:8px;">
+        <div style="display:flex;align-items:center;gap:8px;">
+          <span style="font-size:12px;color:var(--text-secondary);">Codebase Guide</span>
+          <span data-testid=${'guide-status-pill-' + projectName} style=${pillStyle}>${pillLabel}</span>
+        </div>
+        <div style="display:flex;gap:6px;">
+          ${canShowContent ? html`
+            <button class="btn btn-sm btn-secondary"
+                    onClick=${() => setExpanded(e => !e)}>
+              ${expanded ? 'Collapse' : 'Expand'}
+            </button>
+          ` : null}
+          ${canReanalyze ? html`
+            <button class="btn btn-sm btn-secondary" onClick=${reanalyze}>Re-analyze</button>
+          ` : null}
+        </div>
+      </div>
+      ${error ? html`<div class="error-msg" style="margin:0;">${error}</div>` : null}
+      ${(canShowContent && expanded) ? html`
+        <div data-testid=${'guide-content-' + projectName}
+             class="guide-content"
+             style="max-height:300px;overflow-y:auto;font-size:0.85rem;white-space:pre-wrap;background:var(--bg-secondary);padding:8px;border-radius:var(--radius-sm);border:1px solid var(--border);">
+          ${guideContent === null ? 'Loading…' : guideContent}
+        </div>
+      ` : null}
+    </div>
+  `;
+}
+
 // ================================================================
 // Projects Page
 // ================================================================
@@ -8605,6 +8721,9 @@ function ProjectsPage({ selectedProject, onProjectChange }) {
   const [onboardingTier, setOnboardingTier] = useState('standard');
   const [showPicker, setShowPicker] = useState(false);
   const [adding, setAdding] = useState(false);
+  const [analysisStage, setAnalysisStage] = useState(null);
+  const [fullTierGuide, setFullTierGuide] = useState(null);
+  const [fullTierProject, setFullTierProject] = useState(null);
 
   const fetchProjects = useCallback(() => {
     api('GET', '/api/projects')
@@ -8634,21 +8753,69 @@ function ProjectsPage({ selectedProject, onProjectChange }) {
       setSuccess(isGithub ? `Cloned and added: ${registeredPath}` : 'Project added successfully');
 
       if (onboardingTier === 'standard' || onboardingTier === 'full') {
-        setSuccess('Project added — running codebase analysis...');
+        const tier = onboardingTier;
+        setAnalysisStage('clone');
+        setSuccess('Cloning repository...');
         try {
           await api('POST', '/api/projects/' + projName + '/analyze', {});
-          setSuccess('Project added and analyzed');
-        } catch { setSuccess('Project added (analysis failed — can retry later)'); }
-      }
-
-      if (onboardingTier === 'full') {
-        setTimeout(() => {
-          if (onProjectChange) onProjectChange(projName);
-          navigate('#/new-session');
-        }, 1000);
+        } catch {
+          setAnalysisStage(null);
+          setSuccess('Project added (analysis failed — can retry later)');
+          setTimeout(() => setSuccess(null), 5000);
+          fetchProjects();
+          return;
+        }
+        const startedAt = Date.now();
+        const poll = setInterval(async () => {
+          let st = 'running';
+          try {
+            const data = await api('GET', '/api/projects/' + projName + '/analyze/status');
+            st = (data && data.status) ? data.status : 'running';
+          } catch {
+            return;
+          }
+          if (st === 'running') {
+            const elapsed = (Date.now() - startedAt) / 1000;
+            const stage = elapsed < 3 ? 'clone' : (elapsed < 6 ? 'detect' : 'analyze');
+            setAnalysisStage(stage);
+            setSuccess(
+              stage === 'clone' ? 'Cloning repository...'
+              : stage === 'detect' ? 'Detecting stack...'
+              : 'Analyzing codebase...'
+            );
+          } else if (st === 'complete' || st === 'cached') {
+            clearInterval(poll);
+            setAnalysisStage('ready');
+            setSuccess('✓ Analysis complete — codebase guide ready');
+            fetchProjects();
+            if (tier === 'full') {
+              try {
+                const data = await api('GET', '/api/projects/' + projName + '/codebase-guide?level=l1');
+                let content = (data && (data.content || data.guide || data.l1)) || '';
+                if (typeof data === 'string') content = data;
+                if (content && content.startsWith('# ')) {
+                  const nl = content.indexOf('\n');
+                  content = nl >= 0 ? content.slice(nl + 1).replace(/^\s*\n/, '') : '';
+                }
+                setFullTierGuide(content || '');
+                setFullTierProject(projName);
+              } catch {
+                setFullTierGuide('Guide not available');
+                setFullTierProject(projName);
+              }
+            }
+            setTimeout(() => setSuccess(null), 3000);
+          } else if (st === 'failed') {
+            clearInterval(poll);
+            setAnalysisStage(null);
+            setSuccess('Analysis failed — can retry from project settings');
+            setTimeout(() => setSuccess(null), 5000);
+          }
+        }, 2000);
+      } else {
+        setTimeout(() => setSuccess(null), 5000);
       }
 
-      setTimeout(() => setSuccess(null), 5000);
       fetchProjects();
     } catch (e) { setError(e.message); }
     finally { setAdding(false); }
@@ -8673,7 +8840,30 @@ function ProjectsPage({ selectedProject, onProjectChange }) {
       </div>
 
       ${error ? html`<div class="error-msg">${error}</div>` : null}
-      ${success ? html`<div class="success-msg">${success}</div>` : null}
+      ${success ? html`
+        <div class="success-msg" data-testid="analysis-toast">
+          <span data-testid="analysis-stage">${success}</span>
+        </div>
+      ` : null}
+      ${fullTierGuide !== null ? html`
+        <div class="card" data-testid="full-tier-guide-panel"
+             style="margin-bottom:16px;border-left:3px solid var(--success);">
+          <div class="card-header">
+            <h3>📋 Codebase Guide: ${fullTierProject}</h3>
+          </div>
+          <div style="max-height:200px;overflow-y:auto;white-space:pre-wrap;font-size:0.85rem;background:var(--bg-secondary);padding:8px;border-radius:var(--radius-sm);border:1px solid var(--border);margin-bottom:12px;">
+            ${fullTierGuide || 'Guide not available'}
+          </div>
+          <button class="btn btn-primary"
+                  data-testid="full-tier-start-session"
+                  onClick=${() => {
+                    if (onProjectChange) onProjectChange(fullTierProject);
+                    navigate('#/new-session');
+                  }}>
+            Start Session →
+          </button>
+        </div>
+      ` : null}
 
       <div style="display:grid;grid-template-columns:1fr 1fr;gap:16px;margin-bottom:24px;">
         <div class="card" style="margin-bottom:0;">
@@ -8754,6 +8944,7 @@ function ProjectsPage({ selectedProject, onProjectChange }) {
               <button class="btn btn-sm btn-danger" onClick=${() => removeProject(proj.name)}>Remove</button>
             </div>
             <${EnvironmentPanel} projectName=${proj.name} />
+            <${CodebaseGuidePanel} projectName=${proj.name} />
           </div>
         `)}
       </div>

package/dist/web/build-commit.txt

@@ -1 +1 @@
-9b7919f2f37b2df8970a22192792a3ff8649fdc2
+fd318eaec11e30ebe601cbd90b2b8c3f7cb3b7cd

package/dist/web/build-stamp.txt

@@ -1 +1 @@
-20260517-095752-9b7919f
+20260517-110542-fd318ea

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beastmode-develeap/beastmode",
-  "version": "0.1.296",
+  "version": "0.1.298",
   "description": "BeastMode Dark Factory — turn intent into verified software",
   "type": "module",
   "bin": {