@n-dx/web 0.1.0

package/dist/viewer/components/faq.js

@@ -0,0 +1,237 @@
+import { h, Fragment } from "preact";
+import { useState, useEffect, useCallback } from "preact/hooks";
+const FAQ_SECTIONS = [
+    {
+        title: "Getting Started",
+        items: [
+            {
+                question: "How do I set up n-dx for a new project?",
+                answer: "Run 'ndx init .' in your project root. This initializes SourceVision (static analysis), Rex (PRD management), and Hench (autonomous agent) directories.",
+                docLink: { label: "Overview", hash: "overview" },
+            },
+            {
+                question: "What does 'ndx plan' do?",
+                answer: "It runs SourceVision analysis on your codebase and feeds the results into Rex, which proposes epics, features, and tasks for your PRD. Use 'ndx plan --accept' to add proposals to your PRD.",
+            },
+            {
+                question: "How do I execute tasks autonomously?",
+                answer: "Run 'ndx work .' to let Hench pick the next Rex task, build a brief, and execute it using Claude in a tool-use loop. You can target a specific task with '--task=ID'.",
+            },
+        ],
+    },
+    {
+        title: "SourceVision",
+        items: [
+            {
+                question: "What are zones and how are they detected?",
+                answer: "Zones are architectural areas detected by Louvain community detection on the import graph. Files with strong internal connections cluster into zones. Low cohesion (<0.4) suggests a zone should be split; high coupling (>0.6) suggests merging.",
+                docLink: { label: "Zones view", hash: "zones" },
+            },
+            {
+                question: "What are enrichment passes?",
+                answer: "SourceVision runs multiple analysis passes. Pass 1 covers inventory, imports, zones, and components. Passes 2-4 add AI-generated architecture insights, problem detection, and suggestions. Run additional 'sourcevision analyze' passes for deeper analysis.",
+            },
+            {
+                question: "What does the import graph show?",
+                answer: "A force-directed visualization where nodes are files colored by zone. Orange cross-zone edges highlight potential boundary violations. Dense clusters suggest tight coupling; isolated nodes may be dead code.",
+                docLink: { label: "Import Graph", hash: "graph" },
+            },
+        ],
+    },
+    {
+        title: "Rex (PRD Management)",
+        items: [
+            {
+                question: "How is the PRD structured?",
+                answer: "The PRD is a tree: epics contain features, features contain tasks, and tasks can have subtasks. Each item has a status (pending, in_progress, completed, deferred, blocked, deleted), priority, and optional acceptance criteria.",
+                docLink: { label: "Tasks view", hash: "prd" },
+            },
+            {
+                question: "How does Rex determine the next task?",
+                answer: "Rex considers priority (critical > high > medium > low), dependency blocking (items with unresolved blockers are skipped), and tree position (earlier items in the tree are preferred).",
+                docLink: { label: "Rex Dashboard", hash: "rex-dashboard" },
+            },
+            {
+                question: "Can I sync my PRD with Notion?",
+                answer: "Yes. Configure a Notion adapter, then run 'ndx sync .' to bidirectionally sync your local PRD with a Notion database. Use '--push' or '--pull' for one-way sync.",
+            },
+        ],
+    },
+    {
+        title: "Hench (Autonomous Agent)",
+        items: [
+            {
+                question: "What happens during an autonomous run?",
+                answer: "Hench picks the next Rex task, generates a detailed brief with context from SourceVision and Rex, then calls Claude in a tool-use loop. It reads files, writes code, runs tests, and commits changes. Runs are recorded in .hench/runs/.",
+                docLink: { label: "Hench Runs", hash: "hench-runs" },
+            },
+            {
+                question: "How do I monitor agent progress?",
+                answer: "Use 'ndx status .' to check PRD completion. The Hench Runs view in this dashboard shows run history, transcripts, and token usage for each autonomous execution.",
+                docLink: { label: "Token Usage", hash: "token-usage" },
+            },
+            {
+                question: "Can I limit which tasks Hench works on?",
+                answer: "Yes. Use 'ndx work --task=ID' to target a specific task. You can also use '--dry-run' to see what Hench would do without executing. Configure model and max turns in .hench/config.json.",
+            },
+        ],
+    },
+    {
+        title: "Dashboard",
+        items: [
+            {
+                question: "How do I switch between light and dark mode?",
+                answer: "Use the theme toggle (sun/moon icon) in the sidebar footer. Your preference is saved automatically and persists across sessions.",
+            },
+            {
+                question: "What do the locked navigation items mean?",
+                answer: "Items marked with P2, P3, or P4 badges require additional SourceVision enrichment passes. Run more 'sourcevision analyze' passes to unlock Architecture, Problems, and Suggestions views.",
+            },
+            {
+                question: "Can I run the dashboard in the background?",
+                answer: "Yes. Run 'ndx web --background .' to start the dashboard as a daemon. Use 'ndx web stop' to stop it and 'ndx web status' to check if it's running.",
+            },
+        ],
+    },
+];
+/**
+ * Map view IDs to the FAQ section title that is most relevant.
+ * Used by HeaderFAQ to auto-expand the contextual section.
+ */
+const VIEW_TO_FAQ_SECTION = {
+    // SourceVision views
+    overview: "SourceVision",
+    graph: "SourceVision",
+    zones: "SourceVision",
+    files: "SourceVision",
+    routes: "SourceVision",
+    architecture: "SourceVision",
+    problems: "SourceVision",
+    suggestions: "SourceVision",
+    "pr-markdown": "SourceVision",
+    // Rex views
+    "rex-dashboard": "Rex (PRD Management)",
+    prd: "Rex (PRD Management)",
+    "token-usage": "Dashboard",
+    validation: "Rex (PRD Management)",
+    // Hench views
+    "hench-runs": "Hench (Autonomous Agent)",
+};
+/** Shared FAQ modal body — used by both sidebar FAQ and header FAQ */
+function FAQModal({ onClose, initialSection }) {
+    const [expandedSection, setExpandedSection] = useState(initialSection);
+    const toggleSection = useCallback((title) => {
+        setExpandedSection((prev) => (prev === title ? null : title));
+    }, []);
+    return h("div", {
+        class: "faq-overlay",
+        onClick: onClose,
+        role: "dialog",
+        "aria-label": "Help and FAQ",
+        "aria-modal": "true",
+    }, h("div", {
+        class: "faq-modal",
+        onClick: (e) => e.stopPropagation(),
+    }, h("div", { class: "faq-header" }, h("h2", null, "Help & FAQ"), h("button", {
+        class: "faq-close",
+        onClick: onClose,
+        "aria-label": "Close FAQ",
+    }, "\u2715")), h("div", { class: "faq-body" }, FAQ_SECTIONS.map((section) => {
+        const isExpanded = expandedSection === section.title;
+        return h("div", { key: section.title, class: "faq-section" }, h("div", {
+            class: "faq-section-header",
+            role: "button",
+            tabIndex: 0,
+            "aria-expanded": String(isExpanded),
+            onClick: () => toggleSection(section.title),
+            onKeyDown: (e) => {
+                if (e.key === "Enter" || e.key === " ") {
+                    e.preventDefault();
+                    toggleSection(section.title);
+                }
+            },
+        }, h("span", {
+            class: `faq-section-chevron${isExpanded ? " faq-section-chevron-open" : ""}`,
+            "aria-hidden": "true",
+        }, "\u25B8"), h("span", null, section.title)), isExpanded
+            ? h("div", { class: "faq-section-items" }, section.items.map((item, i) => h("div", { key: i, class: "faq-item" }, h("div", { class: "faq-question" }, item.question), h("div", { class: "faq-answer" }, item.answer), item.docLink
+                ? h("a", {
+                    class: "faq-doc-link",
+                    href: `#${item.docLink.hash}`,
+                    onClick: onClose,
+                }, `\u2192 ${item.docLink.label}`)
+                : null)))
+            : null);
+    })), h("div", { class: "faq-footer" }, h("p", null, "For CLI reference, run ", h("code", null, "ndx --help"), " or ", h("code", null, "ndx <command> --help")))));
+}
+/**
+ * Global FAQ button — lives in the sidebar footer toolbar (bottom-left).
+ * Opens the full FAQ modal without view-contextual auto-expansion.
+ */
+export function GlobalFAQ() {
+    const [open, setOpen] = useState(false);
+    // Close on Escape
+    useEffect(() => {
+        if (!open)
+            return;
+        const handler = (e) => {
+            if (e.key === "Escape")
+                setOpen(false);
+        };
+        window.addEventListener("keydown", handler);
+        return () => window.removeEventListener("keydown", handler);
+    }, [open]);
+    return h(Fragment, null, h("button", {
+        class: "sidebar-control-btn global-faq-btn",
+        onClick: () => setOpen(true),
+        title: "Help & FAQ",
+        "aria-label": "Open help and FAQ",
+    }, h("svg", {
+        width: 14,
+        height: 14,
+        viewBox: "0 0 16 16",
+        fill: "none",
+        stroke: "currentColor",
+        "stroke-width": "1.5",
+        "stroke-linecap": "round",
+        "stroke-linejoin": "round",
+        "aria-hidden": "true",
+    }, h("circle", { cx: 8, cy: 8, r: 7 }), h("path", { d: "M5.5 6a2.5 2.5 0 0 1 4.9.5c0 1.5-2.4 2-2.4 3" }), h("circle", { cx: 8, cy: 12, r: 0.5, fill: "currentColor", stroke: "none" }))), open ? h(FAQModal, { onClose: () => setOpen(false), initialSection: null }) : null);
+}
+/**
+ * Header FAQ button — contextual entry point in the content area header.
+ * Auto-expands the FAQ section relevant to the current view.
+ */
+export function HeaderFAQ({ view }) {
+    const [open, setOpen] = useState(false);
+    // Determine which FAQ section to auto-expand based on current view
+    const contextSection = VIEW_TO_FAQ_SECTION[view] ?? FAQ_SECTIONS[0].title;
+    // Close on Escape
+    useEffect(() => {
+        if (!open)
+            return;
+        const handler = (e) => {
+            if (e.key === "Escape")
+                setOpen(false);
+        };
+        window.addEventListener("keydown", handler);
+        return () => window.removeEventListener("keydown", handler);
+    }, [open]);
+    return h(Fragment, null, h("button", {
+        class: "header-faq-btn",
+        onClick: () => setOpen(true),
+        title: "Help & FAQ",
+        "aria-label": "Open contextual help and FAQ",
+    }, h("svg", {
+        width: 14,
+        height: 14,
+        viewBox: "0 0 16 16",
+        fill: "none",
+        stroke: "currentColor",
+        "stroke-width": "1.5",
+        "stroke-linecap": "round",
+        "stroke-linejoin": "round",
+        "aria-hidden": "true",
+    }, h("circle", { cx: 8, cy: 8, r: 7 }), h("path", { d: "M5.5 6a2.5 2.5 0 0 1 4.9.5c0 1.5-2.4 2-2.4 3" }), h("circle", { cx: 8, cy: 12, r: 0.5, fill: "currentColor", stroke: "none" }))), open ? h(FAQModal, { onClose: () => setOpen(false), initialSection: contextSection }) : null);
+}
+//# sourceMappingURL=faq.js.map

package/dist/viewer/components/faq.js.map

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

package/dist/viewer/components/favicon.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Dynamic favicon management.
+ *
+ * Uses PNG favicons for each product section and swaps
+ * the <link rel="icon"> element when the active view changes.
+ * Falls back to the n-dx logo on non-package-specific pages.
+ */
+import type { ViewId } from "../types.js";
+type Product = "sourcevision" | "rex" | "hench";
+declare const FAVICON_PNGS: Record<Product | "ndx", string>;
+/**
+ * Map from ViewId → the product that owns it.
+ * Views not in this map default to the n-dx favicon.
+ */
+declare const VIEW_TO_PRODUCT: Partial<Record<ViewId, Product>>;
+/**
+ * Update the browser favicon to match the active view's product section.
+ *
+ * Call this whenever the view changes. It determines the owning product
+ * from the ViewId and swaps the favicon accordingly. Non-package views
+ * (if any) fall back to the n-dx logo.
+ */
+export declare function updateFavicon(view: ViewId): void;
+/**
+ * Reset internal cache. Call between tests to avoid stale references
+ * when the DOM is torn down and rebuilt.
+ */
+export declare function resetFavicon(): void;
+/** Exported for testing. */
+export { FAVICON_PNGS, VIEW_TO_PRODUCT };

package/dist/viewer/components/favicon.js

@@ -0,0 +1,90 @@
+/**
+ * Dynamic favicon management.
+ *
+ * Uses PNG favicons for each product section and swaps
+ * the <link rel="icon"> element when the active view changes.
+ * Falls back to the n-dx logo on non-package-specific pages.
+ */
+/* ── PNG favicon paths ──
+ *
+ * Each product has a branded PNG favicon. These are served as static
+ * assets by the web server and copied into dist/viewer/ at build time.
+ */
+const FAVICON_PNGS = {
+    /** n-dx — default brand mark */
+    ndx: "/n-dx.png",
+    /** SourceVision — pixel-art eye icon */
+    sourcevision: "/SourceVision-F.png",
+    /** Rex — pixel-art dinosaur icon */
+    rex: "/Rex-F.png",
+    /** Hench — pixel-art wrench icon */
+    hench: "/Hench-F.png",
+};
+/**
+ * Map from ViewId → the product that owns it.
+ * Views not in this map default to the n-dx favicon.
+ */
+const VIEW_TO_PRODUCT = {
+    overview: "sourcevision",
+    graph: "sourcevision",
+    zones: "sourcevision",
+    files: "sourcevision",
+    routes: "sourcevision",
+    architecture: "sourcevision",
+    problems: "sourcevision",
+    suggestions: "sourcevision",
+    "pr-markdown": "sourcevision",
+    "rex-dashboard": "rex",
+    prd: "rex",
+    validation: "rex",
+    "hench-runs": "hench",
+    "hench-audit": "hench",
+};
+/** Cached reference to the <link rel="icon"> element. */
+let faviconLink = null;
+function getFaviconLink() {
+    if (faviconLink)
+        return faviconLink;
+    // Look for existing favicon link
+    const existing = document.querySelector('link[rel="icon"]');
+    if (existing) {
+        faviconLink = existing;
+        return faviconLink;
+    }
+    // Create one if missing (shouldn't happen in practice)
+    const link = document.createElement("link");
+    link.rel = "icon";
+    link.type = "image/png";
+    document.head.appendChild(link);
+    faviconLink = link;
+    return faviconLink;
+}
+/** Track current favicon to avoid redundant DOM updates. */
+let currentProduct = null;
+/**
+ * Update the browser favicon to match the active view's product section.
+ *
+ * Call this whenever the view changes. It determines the owning product
+ * from the ViewId and swaps the favicon accordingly. Non-package views
+ * (if any) fall back to the n-dx logo.
+ */
+export function updateFavicon(view) {
+    const product = VIEW_TO_PRODUCT[view] ?? "ndx";
+    if (product === currentProduct)
+        return;
+    currentProduct = product;
+    const link = getFaviconLink();
+    link.type = "image/png";
+    link.href = FAVICON_PNGS[product];
+}
+/**
+ * Reset internal cache. Call between tests to avoid stale references
+ * when the DOM is torn down and rebuilt.
+ */
+export function resetFavicon() {
+    faviconLink = null;
+    currentProduct = null;
+}
+/** Exported for testing. */
+export { FAVICON_PNGS, VIEW_TO_PRODUCT };
+//# sourceMappingURL=favicon.js.map

package/dist/viewer/components/favicon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"favicon.js","sourceRoot":"","sources":["../../../src/viewer/components/favicon.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;GAIG;AAEH,MAAM,YAAY,GAAoC;IACpD,gCAAgC;IAChC,GAAG,EAAE,WAAW;IAEhB,wCAAwC;IACxC,YAAY,EAAE,qBAAqB;IAEnC,oCAAoC;IACpC,GAAG,EAAE,YAAY;IAEjB,oCAAoC;IACpC,KAAK,EAAE,cAAc;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,eAAe,GAAqC;IACxD,QAAQ,EAAE,cAAc;IACxB,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,cAAc;IAC7B,eAAe,EAAE,KAAK;IACtB,GAAG,EAAE,KAAK;IACV,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE,OAAO;IACrB,aAAa,EAAE,OAAO;CACvB,CAAC;AAEF,yDAAyD;AACzD,IAAI,WAAW,GAA2B,IAAI,CAAC;AAE/C,SAAS,cAAc;IACrB,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,iCAAiC;IACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAkB,kBAAkB,CAAC,CAAC;IAC7E,IAAI,QAAQ,EAAE,CAAC;QACb,WAAW,GAAG,QAAQ,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,uDAAuD;IACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC;IAClB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,GAAG,IAAI,CAAC;IACnB,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,4DAA4D;AAC5D,IAAI,cAAc,GAA2B,IAAI,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IAC/C,IAAI,OAAO,KAAK,cAAc;QAAE,OAAO;IAEvC,cAAc,GAAG,OAAO,CAAC;IACzB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IACxB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,WAAW,GAAG,IAAI,CAAC;IACnB,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC;AAED,4BAA4B;AAC5B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/viewer/components/guide.d.ts

@@ -0,0 +1,5 @@
+interface GuideProps {
+    view: string;
+}
+export declare function Guide({ view }: GuideProps): import("preact").VNode<import("preact").Attributes>;
+export {};

package/dist/viewer/components/guide.js

@@ -0,0 +1,116 @@
+import { h, Fragment } from "preact";
+import { useState, useEffect } from "preact/hooks";
+const GUIDE_CONTENT = {
+    // ── SourceVision views ──
+    overview: {
+        title: "Overview",
+        description: "Dashboard showing high-level project statistics: file counts, languages, import density, zone structure, and module completion status.",
+        lookFor: "High import counts on single files (hub files). Circular dependencies. Unbalanced language distribution.",
+        actions: "Check module status table to see which analysis phases have completed. Run additional 'sourcevision analyze' passes for deeper AI-generated insights.",
+    },
+    graph: {
+        title: "Import Graph",
+        description: "Force-directed visualization of the import graph. Nodes are colored by zone. Cross-zone edges are highlighted in orange.",
+        lookFor: "Dense clusters suggest tightly-coupled modules. Orange cross-zone edges indicate zone boundary violations. Isolated nodes may be dead code.",
+        actions: "Click nodes to inspect. Look for hub files that could be split. Consider if cross-zone imports suggest zones should be merged or boundaries clarified.",
+    },
+    zones: {
+        title: "Zones",
+        description: "Architectural zones detected by Louvain community detection. Each zone groups files with strong internal import connections.",
+        lookFor: "Cohesion < 0.4 means files in a zone aren't well-related — consider splitting. Coupling > 0.6 means heavy cross-zone dependencies. Large zones (>50 files) may need decomposition.",
+        actions: "Click a zone to see its files and entry points. Review AI-generated insights. Check if zone boundaries match your intended architecture.",
+    },
+    files: {
+        title: "Files",
+        description: "Sortable, filterable table of all project files with language, role, size, and category information.",
+        lookFor: "Very large files (>500 lines) that might benefit from splitting. Files classified as 'other' role that should be reclassified. Category groupings that reveal organizational patterns.",
+        actions: "Sort by line count to find the largest files. Filter by role to focus on source, test, or config files. Use search to locate specific files.",
+    },
+    routes: {
+        title: "Routes",
+        description: "Route tree showing React Router v7 / Remix file-based routes with their convention exports (loader, action, meta, etc).",
+        lookFor: "Route modules missing loaders (data fetching). Missing ErrorBoundary exports. Deep layout nesting. Routes without meta exports (SEO gaps).",
+        actions: "Check convention coverage stats to identify missing exports. Review the route tree for proper nesting. Look at component usage for shared UI patterns.",
+    },
+    architecture: {
+        title: "Architecture",
+        description: "Architectural patterns and relationships identified by AI analysis. Requires enrichment pass 2.",
+        lookFor: "Cross-cutting concerns, shared utilities, interface boundaries between zones, dependency direction patterns.",
+        actions: "Compare observed patterns against your intended architecture. Look for findings tagged as relationships — these show how zones interact.",
+    },
+    problems: {
+        title: "Problems",
+        description: "Anti-patterns and issues identified by AI analysis. Grouped by severity (critical, warning, info). Requires enrichment pass 3.",
+        lookFor: "Critical issues first. Circular dependencies between zones. God files. Leaky abstractions. Tight coupling patterns.",
+        actions: "Address critical findings first. Group related warnings for batch fixes. Use related file references to understand the scope of each issue.",
+    },
+    suggestions: {
+        title: "Suggestions",
+        description: "Improvement suggestions from AI analysis. Requires enrichment pass 4.",
+        lookFor: "Quick wins vs larger refactors. Suggestions that align with your current sprint goals. Patterns that could benefit from abstraction.",
+        actions: "Prioritize suggestions by scope (global vs zone-specific). Start with suggestions that reduce coupling or improve cohesion.",
+    },
+    "pr-markdown": {
+        title: "PR Markdown",
+        description: "PR-ready markdown generated for copy/paste into pull request descriptions.",
+        lookFor: "Clear summary, accurate file/change grouping, and any missing sections before sharing.",
+        actions: "Copy sections into your PR description and refresh after major changes to keep the text current.",
+    },
+    // ── Rex views ──
+    "rex-dashboard": {
+        title: "Rex Dashboard",
+        description: "PRD completion overview showing epic progress, priority distribution, and recent activity. Each epic displays a segmented progress bar with status breakdowns.",
+        lookFor: "Epics with low completion rates or many blocked tasks. Imbalanced priority distribution (too many critical items may indicate scope creep). Stalled items that haven't progressed.",
+        actions: "Click an epic to see its tasks. Review blocked items and resolve dependencies. Use the execution panel to run the next task autonomously.",
+    },
+    prd: {
+        title: "Tasks",
+        description: "Interactive PRD tree showing the full hierarchy: epics → features → tasks → subtasks. Each item shows its status, priority, and tags. Supports multi-select for bulk operations.",
+        lookFor: "Tasks stuck in 'in_progress' for too long. Blocked items with unresolved dependencies. Orphaned subtasks without clear parent context. Items missing acceptance criteria.",
+        actions: "Click items to view details in the side panel. Use bulk actions to update multiple items at once. Merge duplicate tasks. Add new items at any level of the hierarchy.",
+    },
+    "token-usage": {
+        title: "Token Usage",
+        description: "Analytics dashboard showing token consumption across autonomous agent runs. Tracks input/output tokens, costs, and usage trends over time.",
+        lookFor: "Runs with unusually high token counts (may indicate stuck loops). Cost trends over time. Token distribution across epics to understand where effort is spent.",
+        actions: "Review high-cost runs for optimization opportunities. Compare token usage across similar tasks. Use the grouping controls to view usage by day, week, or month.",
+    },
+    validation: {
+        title: "Validation",
+        description: "PRD integrity checks that verify the health of your task tree. Detects orphaned items, circular dependencies, invalid references, and structural issues.",
+        lookFor: "Critical validation errors (must be fixed). Orphaned items disconnected from the tree. Circular blockedBy references that create deadlocks. Items with invalid status transitions.",
+        actions: "Fix critical errors first — they can prevent task execution. Resolve orphaned items by reparenting or deleting them. Clear circular dependencies by editing blockedBy fields.",
+    },
+    // ── Hench views ──
+    "hench-runs": {
+        title: "Execution History",
+        description: "Timeline of autonomous agent runs showing status, duration, token usage, and task associations. Each run records the full execution transcript.",
+        lookFor: "Failed runs that need investigation. Runs with high turn counts (may indicate the agent struggled). Patterns in which tasks succeed vs fail autonomously.",
+        actions: "Click a run to see its full details and token breakdown. Review failed runs to understand what went wrong. Use insights to improve task descriptions and acceptance criteria.",
+    },
+};
+export function Guide({ view }) {
+    const [open, setOpen] = useState(false);
+    const content = GUIDE_CONTENT[view] || GUIDE_CONTENT.overview;
+    // Close on Escape key
+    useEffect(() => {
+        if (!open)
+            return;
+        const handler = (e) => {
+            if (e.key === "Escape")
+                setOpen(false);
+        };
+        window.addEventListener("keydown", handler);
+        return () => window.removeEventListener("keydown", handler);
+    }, [open]);
+    return h(Fragment, null, h("button", {
+        class: "guide-btn",
+        onClick: () => setOpen(!open),
+        title: "View guide",
+        "aria-label": "View guide for this page",
+        "aria-expanded": String(open),
+    }, "?"), open
+        ? h("div", { class: "guide-overlay", onClick: () => setOpen(false), role: "dialog", "aria-modal": "true", "aria-label": `Guide: ${content.title}` }, h("div", { class: "guide-modal", onClick: (e) => e.stopPropagation() }, h("div", { class: "guide-header" }, h("h2", null, content.title), h("button", { class: "guide-close", onClick: () => setOpen(false), "aria-label": "Close guide" }, "\u2715")), h("div", { class: "guide-body" }, h("section", null, h("h3", null, "What you're looking at"), h("p", null, content.description)), h("section", null, h("h3", null, "What to look for"), h("p", null, content.lookFor)), h("section", null, h("h3", null, "What actions to take"), h("p", null, content.actions)))))
+        : null);
+}
+//# sourceMappingURL=guide.js.map

package/dist/viewer/components/guide.js.map

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

package/dist/viewer/components/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Dashboard panel components — public barrel.
+ *
+ * All cross-zone consumers should import from this barrel rather than
+ * individual component files. This provides a single stable import surface
+ * and makes it possible to split the zone later without auditing individual
+ * import paths across consumer layers.
+ */
+export { ActiveTasksPanel } from "./active-tasks-panel.js";
+export type { ActiveRun } from "./active-tasks-panel.js";
+export { ConcurrencyPanel } from "./concurrency-panel.js";
+export { MemoryPanel } from "./memory-panel.js";
+export { WsHealthPanel } from "./ws-health-panel.js";
+export { ThrottleControlsPanel } from "./throttle-controls.js";
+export { DetailPanel } from "./detail-panel.js";
+export { CrashRecoveryBanner } from "./crash-recovery-banner.js";
+export { DegradationBanner, type DegradationBannerProps, } from "./degradation-banner.js";
+export { MemoryWarningBanner } from "./memory-warning.js";
+export { Breadcrumb, type BreadcrumbProps, } from "./breadcrumb.js";
+export { CopyLinkButton, buildShareableUrl, type CopyLinkButtonProps, } from "./copy-link-button.js";
+export { ConfigFooter } from "./config-footer.js";
+export { ElapsedTime } from "./elapsed-time.js";
+export { updateFavicon, resetFavicon, FAVICON_PNGS, VIEW_TO_PRODUCT } from "./favicon.js";
+export { SidebarThemeToggle, initTheme } from "./theme-toggle.js";
+export { NdxLogoPng, ProductLogoPng, BrandedHeader } from "./logos.js";
+export { PollingSuspensionIndicator } from "./polling-suspension-indicator.js";
+export { RefreshQueueStatus } from "./refresh-queue-status.js";
+export { useProjectStatus, SvFreshnessIndicator, RexCompletionIndicator, HenchActivityIndicator, type ProjectStatus, type SourceVisionStatus, type RexStatus, type HenchStatus, } from "./status-indicators.js";
+export { SearchFilter } from "./search-filter.js";
+export { SearchOverlay, useSearchOverlay } from "./search-overlay.js";
+export { RexTaskLink, type RexTaskLinkProps, type TaskRef, } from "./rex-task-link.js";
+export { Sidebar } from "./sidebar.js";
+export { Guide } from "./guide.js";
+export { GlobalFAQ } from "./faq.js";
+export { NotionSchemaWizard } from "./notion-schema-wizard.js";
+export { ZoneSlideout } from "./zone-slideout.js";
+export * from "./constants.js";

package/dist/viewer/components/index.js

@@ -0,0 +1,46 @@
+/**
+ * Dashboard panel components — public barrel.
+ *
+ * All cross-zone consumers should import from this barrel rather than
+ * individual component files. This provides a single stable import surface
+ * and makes it possible to split the zone later without auditing individual
+ * import paths across consumer layers.
+ */
+// ── Panel components ─────────────────────────────────────────────────
+export { ActiveTasksPanel } from "./active-tasks-panel.js";
+export { ConcurrencyPanel } from "./concurrency-panel.js";
+export { MemoryPanel } from "./memory-panel.js";
+export { WsHealthPanel } from "./ws-health-panel.js";
+export { ThrottleControlsPanel } from "./throttle-controls.js";
+export { DetailPanel } from "./detail-panel.js";
+// ── Banners ──────────────────────────────────────────────────────────
+export { CrashRecoveryBanner } from "./crash-recovery-banner.js";
+export { DegradationBanner, } from "./degradation-banner.js";
+export { MemoryWarningBanner } from "./memory-warning.js";
+// ── UI primitives ────────────────────────────────────────────────────
+export { Breadcrumb, } from "./breadcrumb.js";
+export { CopyLinkButton, buildShareableUrl, } from "./copy-link-button.js";
+export { ConfigFooter } from "./config-footer.js";
+export { ElapsedTime } from "./elapsed-time.js";
+export { updateFavicon, resetFavicon, FAVICON_PNGS, VIEW_TO_PRODUCT } from "./favicon.js";
+export { SidebarThemeToggle, initTheme } from "./theme-toggle.js";
+export { NdxLogoPng, ProductLogoPng, BrandedHeader } from "./logos.js";
+export { PollingSuspensionIndicator } from "./polling-suspension-indicator.js";
+export { RefreshQueueStatus } from "./refresh-queue-status.js";
+// ── Status indicators ───────────────────────────────────────────────
+export { useProjectStatus, SvFreshnessIndicator, RexCompletionIndicator, HenchActivityIndicator, } from "./status-indicators.js";
+// ── Search ──────────────────────────────────────────────────────────
+export { SearchFilter } from "./search-filter.js";
+export { SearchOverlay, useSearchOverlay } from "./search-overlay.js";
+// ── Task link ───────────────────────────────────────────────────────
+export { RexTaskLink, } from "./rex-task-link.js";
+// ── Navigation ──────────────────────────────────────────────────────
+export { Sidebar } from "./sidebar.js";
+// ── Content ─────────────────────────────────────────────────────────
+export { Guide } from "./guide.js";
+export { GlobalFAQ } from "./faq.js";
+export { NotionSchemaWizard } from "./notion-schema-wizard.js";
+export { ZoneSlideout } from "./zone-slideout.js";
+// ── Constants ───────────────────────────────────────────────────────
+export * from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/viewer/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/viewer/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wEAAwE;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,wEAAwE;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EACL,iBAAiB,GAElB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,wEAAwE;AAExE,OAAO,EACL,UAAU,GAEX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,uEAAuE;AAEvE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GAKvB,MAAM,wBAAwB,CAAC;AAEhC,uEAAuE;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEtE,uEAAuE;AAEvE,OAAO,EACL,WAAW,GAGZ,MAAM,oBAAoB,CAAC;AAE5B,uEAAuE;AAEvE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,uEAAuE;AAEvE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,uEAAuE;AAEvE,cAAc,gBAAgB,CAAC"}