@n-dx/core 0.1.0

package/packages/sourcevision/dist/viewer/components/faq.js

@@ -0,0 +1,162 @@
+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.",
+            },
+        ],
+    },
+];
+export function FAQ() {
+    const [open, setOpen] = useState(false);
+    const [expandedSection, setExpandedSection] = useState(FAQ_SECTIONS[0].title);
+    const toggleSection = useCallback((title) => {
+        setExpandedSection((prev) => (prev === title ? null : 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: "sidebar-control-btn",
+        onClick: () => setOpen(true),
+        title: "Help & FAQ",
+        "aria-label": "Open help and FAQ",
+    }, "?"), open
+        ? h("div", {
+            class: "faq-overlay",
+            onClick: () => setOpen(false),
+            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: () => setOpen(false),
+            "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: () => setOpen(false),
+                    }, `\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")))))
+        : null);
+}
+//# sourceMappingURL=faq.js.map

package/packages/sourcevision/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/packages/sourcevision/dist/viewer/components/findings-list.d.ts

@@ -0,0 +1,13 @@
+import type { Finding } from "../../schema/v1.js";
+interface FindingsListProps {
+    findings: Finding[];
+    legacyInsights?: string[];
+    groupBy?: "severity" | "scope" | "type";
+    searchable?: boolean;
+    threshold?: number;
+}
+export declare function FindingsList({ findings, legacyInsights, groupBy, searchable, threshold, }: FindingsListProps): import("preact").VNode<import("preact").ClassAttributes<HTMLElement> & {
+    role: "region";
+    "aria-label": string;
+}>;
+export {};

package/packages/sourcevision/dist/viewer/components/findings-list.js

@@ -0,0 +1,136 @@
+import { h } from "preact";
+import { useState, useMemo } from "preact/hooks";
+import { CollapsibleSection } from "./collapsible-section.js";
+import { SearchFilter } from "./search-filter.js";
+const SEVERITY_ICON = {
+    critical: "\u26D4", // no entry
+    warning: "\u26A0", // warning sign
+    info: "\u2139", // info
+};
+const TYPE_ICON = {
+    pattern: "\u2B22", // hexagon
+    relationship: "\u2194", // left-right arrow
+    "anti-pattern": "\u2718", // cross
+    suggestion: "\u2728", // sparkles
+};
+export function FindingsList({ findings, legacyInsights = [], groupBy = "severity", searchable = true, threshold = 8, }) {
+    const [search, setSearch] = useState("");
+    const filtered = useMemo(() => {
+        if (!search)
+            return findings;
+        const q = search.toLowerCase();
+        return findings.filter((f) => f.text.toLowerCase().includes(q) ||
+            f.scope.toLowerCase().includes(q) ||
+            (f.related ?? []).some((r) => r.toLowerCase().includes(q)));
+    }, [findings, search]);
+    const filteredLegacy = useMemo(() => {
+        if (!search)
+            return legacyInsights;
+        const q = search.toLowerCase();
+        return legacyInsights.filter((s) => s.toLowerCase().includes(q));
+    }, [legacyInsights, search]);
+    const groups = useMemo(() => {
+        const map = new Map();
+        for (const f of filtered) {
+            let key;
+            switch (groupBy) {
+                case "severity":
+                    key = f.severity || "info";
+                    break;
+                case "scope":
+                    key = f.scope === "global" ? "Global" : f.scope;
+                    break;
+                case "type":
+                    key = f.type;
+                    break;
+                default:
+                    key = "all";
+            }
+            let list = map.get(key);
+            if (!list) {
+                list = [];
+                map.set(key, list);
+            }
+            list.push(f);
+        }
+        if (groupBy === "severity") {
+            const ordered = new Map();
+            for (const sev of ["critical", "warning", "info"]) {
+                const items = map.get(sev);
+                if (items)
+                    ordered.set(sev, items);
+            }
+            return ordered;
+        }
+        return map;
+    }, [filtered, groupBy]);
+    function renderFinding(f, i) {
+        const sev = f.severity || "info";
+        const icon = SEVERITY_ICON[sev] || TYPE_ICON[f.type] || "\u2022";
+        return h("div", {
+            key: i,
+            class: `finding-card severity-${sev}`,
+            role: "article",
+        }, 
+        // Header row: icon + severity badge + scope
+        h("div", { class: "finding-header" }, h("span", { class: "finding-icon", "aria-hidden": "true" }, icon), h("span", {
+            class: `severity-badge severity-${sev}`,
+        }, sev), h("span", { class: "finding-type-badge" }, f.type), f.scope && f.scope !== "global"
+            ? h("span", { class: "finding-scope-link" }, h("span", { class: "finding-zone-dot", style: `background: var(--accent)` }), f.scope)
+            : null), 
+        // Main text
+        h("p", { class: "finding-text" }, f.text), 
+        // Related files/zones
+        f.related?.length
+            ? h("div", { class: "finding-meta" }, h("span", { class: "finding-related-label" }, "Related:"), h("div", { class: "finding-related" }, f.related.map((r, j) => h("code", { key: j }, r))))
+            : null);
+    }
+    return h("div", { role: "region", "aria-label": "Findings list" }, searchable
+        ? h(SearchFilter, {
+            placeholder: "Search findings...",
+            value: search,
+            onInput: setSearch,
+            resultCount: filtered.length + filteredLegacy.length,
+            totalCount: findings.length + legacyInsights.length,
+        })
+        : null, [...groups.entries()].map(([key, items]) => h(CollapsibleSection, {
+        key,
+        title: groupLabel(key, groupBy),
+        count: items.length,
+        defaultOpen: true,
+        threshold,
+    }, ...items.map(renderFinding))), filteredLegacy.length > 0
+        ? h(CollapsibleSection, {
+            title: "Insights",
+            count: filteredLegacy.length,
+            defaultOpen: true,
+            threshold,
+        }, ...filteredLegacy.map((s, i) => h("div", { key: i, class: "finding-card severity-info", role: "article" }, h("div", { class: "finding-header" }, h("span", { class: "finding-icon", "aria-hidden": "true" }, "\u2139"), h("span", { class: "severity-badge severity-info" }, "insight")), h("p", { class: "finding-text" }, s))))
+        : null, filtered.length === 0 && filteredLegacy.length === 0
+        ? h("p", { class: "section-sub" }, "No findings match your search.")
+        : null);
+}
+function groupLabel(key, groupBy) {
+    if (groupBy === "severity") {
+        const labels = {
+            critical: "\u26D4 Critical",
+            warning: "\u26A0 Warnings",
+            info: "\u2139 Info",
+        };
+        return labels[key] || capitalize(key);
+    }
+    if (groupBy === "type") {
+        const labels = {
+            pattern: "\u2B22 Patterns",
+            relationship: "\u2194 Relationships",
+            "anti-pattern": "\u2718 Anti-Patterns",
+            suggestion: "\u2728 Suggestions",
+        };
+        return labels[key] || capitalize(key);
+    }
+    return capitalize(key);
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=findings-list.js.map

package/packages/sourcevision/dist/viewer/components/findings-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings-list.js","sourceRoot":"","sources":["../../../src/viewer/components/findings-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,MAAM,aAAa,GAA2B;IAC5C,QAAQ,EAAE,QAAQ,EAAG,WAAW;IAChC,OAAO,EAAE,QAAQ,EAAI,eAAe;IACpC,IAAI,EAAE,QAAQ,EAAO,OAAO;CAC7B,CAAC;AAEF,MAAM,SAAS,GAA2B;IACxC,OAAO,EAAE,QAAQ,EAAQ,UAAU;IACnC,YAAY,EAAE,QAAQ,EAAG,mBAAmB;IAC5C,cAAc,EAAE,QAAQ,EAAC,QAAQ;IACjC,UAAU,EAAE,QAAQ,EAAK,WAAW;CACrC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,EAC3B,QAAQ,EACR,cAAc,GAAG,EAAE,EACnB,OAAO,GAAG,UAAU,EACpB,UAAU,GAAG,IAAI,EACjB,SAAS,GAAG,CAAC,GACK;IAClB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,IAAI,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC;QAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YACjC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC7D,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvB,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE;QAClC,IAAI,CAAC,MAAM;YAAE,OAAO,cAAc,CAAC;QACnC,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC/B,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IAE7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,GAAW,CAAC;YAChB,QAAQ,OAAO,EAAE,CAAC;gBAChB,KAAK,UAAU;oBACb,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC;oBAC3B,MAAM;gBACR,KAAK,OAAO;oBACV,GAAG,GAAG,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;oBAChD,MAAM;gBACR,KAAK,MAAM;oBACT,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC;oBACb,MAAM;gBACR;oBACE,GAAG,GAAG,KAAK,CAAC;YAChB,CAAC;YACD,IAAI,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,GAAG,EAAE,CAAC;gBACV,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACrB,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;YAC7C,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;gBAClD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC3B,IAAI,KAAK;oBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAExB,SAAS,aAAa,CAAC,CAAU,EAAE,CAAS;QAC1C,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC;QACjC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;QAEjE,OAAO,CAAC,CAAC,KAAK,EAAE;YACd,GAAG,EAAE,CAAC;YACN,KAAK,EAAE,yBAAyB,GAAG,EAAE;YACrC,IAAI,EAAE,SAAS;SAChB;QACC,4CAA4C;QAC5C,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAClC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EACjE,CAAC,CAAC,MAAM,EAAE;YACR,KAAK,EAAE,2BAA2B,GAAG,EAAE;SACxC,EAAE,GAAG,CAAC,EACP,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAClD,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ;YAC7B,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,EACvC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC,EAC5E,CAAC,CAAC,KAAK,CACR;YACH,CAAC,CAAC,IAAI,CACT;QACD,YAAY;QACZ,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;QACzC,sBAAsB;QACtB,CAAC,CAAC,OAAO,EAAE,MAAM;YACf,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAChC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,UAAU,CAAC,EACzD,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,EACnC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAClD,CACF;YACH,CAAC,CAAC,IAAI,CACT,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,EAC/D,UAAU;QACR,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE;YACd,WAAW,EAAE,oBAAoB;YACjC,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,SAAS;YAClB,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM;YACpD,UAAU,EAAE,QAAQ,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM;SACpD,CAAC;QACJ,CAAC,CAAC,IAAI,EAER,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACzC,CAAC,CAAC,kBAAkB,EAAE;QACpB,GAAG;QACH,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;QAC/B,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI;QACjB,SAAS;KACV,EACC,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAC5B,CACF,EAED,cAAc,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE;YACpB,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,cAAc,CAAC,MAAM;YAC5B,WAAW,EAAE,IAAI;YACjB,SAAS;SACV,EACC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC7B,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,IAAI,EAAE,SAAS,EAAE,EACvE,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAClC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EACrE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,EAAE,SAAS,CAAC,CAChE,EACD,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,CACrC,CACF,CACF;QACH,CAAC,CAAC,IAAI,EAER,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAClD,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,gCAAgC,CAAC;QACpE,CAAC,CAAC,IAAI,CACT,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,GAAW,EAAE,OAAe;IAC9C,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,MAAM,MAAM,GAA2B;YACrC,QAAQ,EAAE,iBAAiB;YAC3B,OAAO,EAAE,iBAAiB;YAC1B,IAAI,EAAE,aAAa;SACpB,CAAC;QACF,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,MAAM,GAA2B;YACrC,OAAO,EAAE,iBAAiB;YAC1B,YAAY,EAAE,sBAAsB;YACpC,cAAc,EAAE,sBAAsB;YACtC,UAAU,EAAE,oBAAoB;SACjC,CAAC;QACF,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/packages/sourcevision/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/packages/sourcevision/dist/viewer/components/guide.js

@@ -0,0 +1,77 @@
+import { h, Fragment } from "preact";
+import { useState, useEffect } from "preact/hooks";
+const GUIDE_CONTENT = {
+    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.",
+    },
+};
+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/packages/sourcevision/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/packages/sourcevision/dist/viewer/components/health-gauge.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Health Gauge - A radial progress indicator for metrics like cohesion/coupling.
+ * Shows a value from 0-1 with color coding (green=good, orange=warning, red=bad).
+ */
+interface HealthGaugeProps {
+    value: number;
+    label: string;
+    size?: number;
+    inverted?: boolean;
+}
+export declare function HealthGauge({ value, label, size, inverted }: HealthGaugeProps): import("preact").VNode<import("preact").ClassAttributes<HTMLElement> & {
+    class: string;
+    style: string;
+}>;
+/**
+ * Health Badge - A compact inline indicator for health status.
+ */
+interface HealthBadgeProps {
+    value: number;
+    inverted?: boolean;
+}
+export declare function HealthBadge({ value, inverted }: HealthBadgeProps): import("preact").VNode<import("preact").ClassAttributes<HTMLElement> & {
+    class: string;
+}>;
+/**
+ * Pattern Badge - Shows a pattern or antipattern indicator.
+ */
+interface PatternBadgeProps {
+    type: "pattern" | "antipattern";
+    label: string;
+}
+export declare function PatternBadge({ type, label }: PatternBadgeProps): import("preact").VNode<import("preact").ClassAttributes<HTMLElement> & {
+    class: string;
+}>;
+/**
+ * Metric Card - A card displaying a single metric with visual indicator.
+ */
+interface MetricCardProps {
+    value: string | number;
+    label: string;
+    trend?: "up" | "down" | "neutral";
+    color?: string;
+}
+export declare function MetricCard({ value, label, trend, color }: MetricCardProps): import("preact").VNode<import("preact").ClassAttributes<HTMLElement> & {
+    class: string;
+}>;
+export {};

package/packages/sourcevision/dist/viewer/components/health-gauge.js

@@ -0,0 +1,70 @@
+import { h } from "preact";
+export function HealthGauge({ value, label, size = 80, inverted = false }) {
+    const normalized = Math.max(0, Math.min(1, value));
+    const displayValue = inverted ? 1 - normalized : normalized;
+    // Color based on health (green=good, orange=mid, red=bad)
+    const color = displayValue >= 0.7 ? "var(--green)"
+        : displayValue >= 0.4 ? "var(--orange)"
+            : "var(--red)";
+    // SVG arc parameters
+    const strokeWidth = 8;
+    const radius = (size - strokeWidth) / 2;
+    const circumference = 2 * Math.PI * radius;
+    const progress = normalized * circumference;
+    const cx = size / 2;
+    const cy = size / 2;
+    return h("div", { class: "health-gauge", style: `width: ${size}px` }, h("svg", {
+        viewBox: `0 0 ${size} ${size}`,
+        width: size,
+        height: size,
+    }, 
+    // Background circle
+    h("circle", {
+        cx,
+        cy,
+        r: radius,
+        fill: "none",
+        stroke: "var(--border)",
+        "stroke-width": strokeWidth,
+    }), 
+    // Progress arc
+    h("circle", {
+        cx,
+        cy,
+        r: radius,
+        fill: "none",
+        stroke: color,
+        "stroke-width": strokeWidth,
+        "stroke-linecap": "round",
+        "stroke-dasharray": `${progress} ${circumference}`,
+        "stroke-dashoffset": 0,
+        transform: `rotate(-90 ${cx} ${cy})`,
+        style: "transition: stroke-dasharray 0.3s ease",
+    }), 
+    // Center text
+    h("text", {
+        x: cx,
+        y: cy,
+        "text-anchor": "middle",
+        "dominant-baseline": "central",
+        class: "health-gauge-value",
+        fill: color,
+    }, normalized.toFixed(2))), h("div", { class: "health-gauge-label" }, label));
+}
+export function HealthBadge({ value, inverted = false }) {
+    const normalized = Math.max(0, Math.min(1, value));
+    const displayValue = inverted ? 1 - normalized : normalized;
+    const level = displayValue >= 0.7 ? "good"
+        : displayValue >= 0.4 ? "mid"
+            : "bad";
+    return h("span", { class: `health-badge health-${level}` }, normalized.toFixed(2));
+}
+export function PatternBadge({ type, label }) {
+    const icon = type === "pattern" ? "\u2713" : "\u26A0";
+    return h("span", { class: `pattern-badge ${type}` }, h("span", { class: "pattern-icon" }, icon), label);
+}
+export function MetricCard({ value, label, trend, color }) {
+    const trendIcon = trend === "up" ? "\u2191" : trend === "down" ? "\u2193" : "";
+    return h("div", { class: "metric-card" }, h("div", { class: "metric-value", style: color ? `color: ${color}` : "" }, value, trend ? h("span", { class: `metric-trend metric-trend-${trend}` }, trendIcon) : null), h("div", { class: "metric-label" }, label));
+}
+//# sourceMappingURL=health-gauge.js.map

package/packages/sourcevision/dist/viewer/components/health-gauge.js.map

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