wikifier 4.3.0__tar.gz → 4.3.2__tar.gz

{wikifier-4.3.0/wikifier.egg-info → wikifier-4.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wikifier
-Version: 4.3.0
+Version: 4.3.2
 Summary: Zero-dependency agent-to-agent codebase wiki for LLMs and AI agents. Autonomously maintained via record-change and mark-green for token-efficient lookup of files, dependencies, health, and summaries — across tiny scripts to 50k+ monorepos. Optional MCP server with rich tools for agents.
 Author-email: Aron Amos <aron@example.com>
 Maintainer: Aron Amos
@@ -137,7 +137,7 @@ Works with Claude Desktop, Claude Code, Cursor, Cline, and any Model Context Pro
 
 ## The Human Layer (Secondary, by Design)
 
-`wikifier init` copies a single static `index.html` into your project: a read-only dashboard showing the Mermaid code-structure chart, files with short descriptions, and a folder browser — useful for humans investigating what the agents know. Command buttons copy the exact CLI command and live-poll for results (a static page can't execute shell commands — that's the browser sandbox working as intended). The agent-facing markdown files and tools remain the single source of truth.
+`wikifier init` copies a single static `index.html` into your project: a read-only dashboard showing the Mermaid code-structure chart, files with short descriptions, and a folder browser — useful for humans investigating what the agents know. View it with **`wikifier serve`** (then open http://localhost:8787/index.html) — browsers block `file://` fetches, so a double-clicked index.html can't read the wiki files; the page detects that case and shows you the fix. Command buttons copy the exact CLI command and live-poll for results (a static page can't execute shell commands — that's the browser sandbox working as intended). The agent-facing markdown files and tools remain the single source of truth.
 
 ## Intended Use: Strictly Agent-to-Agent
 

{wikifier-4.3.0 → wikifier-4.3.2}/README.md

@@ -105,7 +105,7 @@ Works with Claude Desktop, Claude Code, Cursor, Cline, and any Model Context Pro
 
 ## The Human Layer (Secondary, by Design)
 
-`wikifier init` copies a single static `index.html` into your project: a read-only dashboard showing the Mermaid code-structure chart, files with short descriptions, and a folder browser — useful for humans investigating what the agents know. Command buttons copy the exact CLI command and live-poll for results (a static page can't execute shell commands — that's the browser sandbox working as intended). The agent-facing markdown files and tools remain the single source of truth.
+`wikifier init` copies a single static `index.html` into your project: a read-only dashboard showing the Mermaid code-structure chart, files with short descriptions, and a folder browser — useful for humans investigating what the agents know. View it with **`wikifier serve`** (then open http://localhost:8787/index.html) — browsers block `file://` fetches, so a double-clicked index.html can't read the wiki files; the page detects that case and shows you the fix. Command buttons copy the exact CLI command and live-poll for results (a static page can't execute shell commands — that's the browser sandbox working as intended). The agent-facing markdown files and tools remain the single source of truth.
 
 ## Intended Use: Strictly Agent-to-Agent
 

{wikifier-4.3.0 → wikifier-4.3.2}/index.html

@@ -5,7 +5,26 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Project Wiki</title>
     <script src="https://cdn.tailwindcss.com"></script>
-    <script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
+    <!-- Version PINNED: the bare mermaid@10 alias let the CDN serve different
+         minors with different config schemas (maxEdges top-level vs nested
+         under flowchart), making large-graph rendering nondeterministic. -->
+    <script src="https://cdn.jsdelivr.net/npm/mermaid@10.9.3/dist/mermaid.min.js"></script>
+    <script>
+        // Configure Mermaid ONCE, immediately:
+        // - startOnLoad:false — the default auto-start processes .mermaid
+        //   elements at page load with default config, racing the explicit
+        //   render in loadMermaid().
+        // - maxEdges in BOTH placements — builds differ on where they read it
+        //   (top-level is also a "secure" key, so it must be set here via
+        //   initialize, never via in-diagram directives). Default 500 broke
+        //   every repo whose graph used the generator's 600-edge budget.
+        if (window.mermaid) mermaid.initialize({
+            startOnLoad: false,
+            theme: 'dark',
+            maxEdges: 1500,
+            flowchart: { maxEdges: 1500 }
+        });
+    </script>
     <style>
         @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&amp;family=Space+Grotesk:wght@500;600&amp;display=swap');
         
@@ -161,7 +180,10 @@
                             class="text-xs px-3 py-1.5 rounded-xl bg-emerald-900/30 hover:bg-emerald-900/50 text-emerald-400 border border-emerald-800">Rebuild tree</button>
                 </div>
                 <div id="mermaid-container" class="bg-slate-950 border border-slate-800 rounded-2xl p-5 min-h-[340px]">
-                    <div id="mermaid-diagram" class="mermaid"></div>
+                    <!-- NOTE: no class="mermaid" here — that class marks
+                         auto-start targets; the render target is the inner
+                         <pre class="mermaid"> created by loadMermaid(). -->
+                    <div id="mermaid-diagram"></div>
                 </div>
                 <div class="mt-4 flex flex-wrap gap-x-3 gap-y-2">
                     <button onclick="copyMermaidSource()" 
@@ -593,12 +615,31 @@
 
             const match = md.match(/```mermaid\n([\s\S]*?)```/);
             if (match && match[1]) {
-                container.innerHTML = `<pre class="mermaid">${match[1]}</pre>`;
+                // textContent (not template-in-innerHTML) so the Mermaid source
+                // can never be interpreted as HTML.
+                container.innerHTML = '<pre class="mermaid"></pre>';
+                container.querySelector('.mermaid').textContent = match[1];
                 if (window.mermaid) {
                     try {
-                        mermaid.initialize({ startOnLoad: false, theme: 'dark' });
+                        // Re-assert the same config as the early <head> init
+                        // (some builds re-read it per render; keep both maxEdges
+                        // placements — see the comment at the script tag).
+                        mermaid.initialize({
+                            startOnLoad: false,
+                            theme: 'dark',
+                            maxEdges: 1500,
+                            flowchart: { maxEdges: 1500 }
+                        });
                         await mermaid.run({ nodes: [container.querySelector('.mermaid')] });
-                    } catch(e) { /* ignore render err */ }
+                    } catch(e) {
+                        // Never fail silently: show what broke + how to inspect.
+                        const msg = (e && (e.message || e.str)) || String(e);
+                        container.innerHTML = `<div class="text-sm p-4 bg-slate-900 border border-amber-700 rounded">
+                            <div class="font-semibold mb-1 text-amber-400">Structure map could not be rendered</div>
+                            <div class="text-slate-300 text-xs font-mono">${String(msg).replace(/[<>&]/g, c => ({'<':'&lt;','>':'&gt;','&':'&amp;'}[c])).slice(0, 300)}</div>
+                            <div class="mt-2 text-[11px] text-slate-400">The underlying map data in <span class="font-mono">library.md</span> is intact — use "Copy structure as text" or open library.md directly.</div>
+                        </div>`;
+                    }
                 }
             } else {
                 container.innerHTML = `<div class="text-xs text-slate-400 p-4">No Mermaid diagram found in library.md.<br>Run <span class="font-mono text-emerald-400">wikifier update-maps</span> then refresh.</div>`;
@@ -770,9 +811,44 @@ Open index.html in the project for the live visual version.
         }
 
         // Boot: only what the human view needs (chart + files+descs + tree + monitor). Poll for live feel.
+        // Browsers refuse fetch() from file:// pages (unique-origin sandbox),
+        // so a double-clicked index.html can never read the wiki artifacts —
+        // the map stays empty while the console fills with CORS errors. Show
+        // the one-command fix prominently instead of failing silently.
+        function showFileProtocolNotice() {
+            const div = document.createElement('div');
+            div.id = 'file-protocol-notice';
+            div.style.cssText = 'position:sticky;top:0;z-index:60;background:#7c2d12;color:#ffedd5;padding:14px 18px;font-size:14px;line-height:1.6;box-shadow:0 2px 8px rgba(0,0,0,.4)';
+            div.innerHTML = '<strong>The dashboard cannot read the wiki files when opened directly from disk.</strong><br>' +
+                'Browsers block <code>fetch()</code> on <code>file://</code> pages (security sandbox), so the map and file list would stay empty. ' +
+                'Serve this folder over localhost instead — run one of these in the project folder, then open the link:' +
+                '<div style="margin-top:8px;display:flex;gap:8px;flex-wrap:wrap;align-items:center">' +
+                '<button id="fpCopyServe" style="background:#10b981;color:#06281e;border:none;border-radius:6px;padding:6px 12px;font-weight:600;cursor:pointer">Copy: wikifier serve</button>' +
+                '<button id="fpCopyPy" style="background:#374151;color:#e5e7eb;border:none;border-radius:6px;padding:6px 12px;cursor:pointer">Copy: python3 -m http.server 8787</button>' +
+                '<a href="http://localhost:8787/index.html" style="color:#5eead4;text-decoration:underline">open http://localhost:8787/index.html</a>' +
+                '</div>';
+            document.body.prepend(div);
+            const wire = (id, text) => {
+                const b = document.getElementById(id);
+                if (!b) return;
+                b.onclick = () => navigator.clipboard.writeText(text).then(() => {
+                    const old = b.textContent;
+                    b.textContent = 'Copied ✓';
+                    setTimeout(() => { b.textContent = old; }, 1600);
+                });
+            };
+            wire('fpCopyServe', 'wikifier serve');
+            wire('fpCopyPy', 'python3 -m http.server 8787');
+        }
+
         function boot() {
             initTailwind();
 
+            if (location.protocol === 'file:') {
+                showFileProtocolNotice();
+                return; // skip data loads + polling: every fetch would fail
+            }
+
             loadHealthMatrix();
             loadMermaid();
             loadMonitorStatus();

{wikifier-4.3.0 → wikifier-4.3.2}/skills/run.md

@@ -250,4 +250,4 @@ All support `project_root=...` and return structured data (plus side-effecting s
 
 See README.md "Intended Use" for the strict agent-to-agent wiki scope (token saving for lookup + autonomous update/create of wiki entries only). M5 dogfood validated this on real external projects with the exact patterns above. Recent 4.0.1 hygiene (health coerce + superseded prune) further improves reliability of the matrix for agents doing direct lookups/updates.
 
-**Human investigation layer (secondary, opt-in)**: `wikifier init` copies only `index.html` (the clean human wiki viewer) into the target project (the folder where MCP/CLI run). `diagnostics.html` (Wikifier maintainer hub) is no longer copied — it would show the wrong tree (Wikifier's internals) and be stale for the host project. Humans open the local `index.html` (via `python -m http.server` recommended) to see a clean visual of *that project's* agent-maintained wiki: prominent code structure / dependency chart (Mermaid) as the hero, followed by a simple "Files & descriptions" list (paths + short "what this file is about" summaries pulled from the wiki notes), and a lightweight "Browse by folder" tree derived from the health data. A "Quick actions" toolbar provides one-click copy buttons for the main commands (check-changes, update-maps, monitor &); empty states ("No structure map yet", "No files in the wiki yet") have prominent primary buttons for first-time commands (update-maps prioritized, combined check-changes+update-maps for files). On first open with no map, the `wikifier update-maps` command is auto-copied (sessionStorage-guarded one-time per browser session) and live-wait mode is immediately activated. Buttons use copy + live-wait: they copy the exact command and inject a fixed top "Waiting for `wikifier ...` to produce data... (auto-polling)" banner with aggressive 3s polling that auto-detects when library.md / file_health.* update (from the terminal run) and refreshes the chart/files automatically; includes an "I ran it — refresh now" link in the banner and a success toast on detection. A short explanatory note in the UI clarifies the model: this is a pure static zero-dep viewer (browser JS cannot execute host shell commands due to security sandbox); the auto we provide is copy + immediate live-wait + fast poll so results (trees, files, descriptions) appear automatically after the user pastes/runs in their terminal. "Good enough" acceptance recorded for this copy+live-wait UX. Prominent copy buttons also export "structure as text" (Mermaid source) and a clean full snapshot (tree + file list + descriptions) — exactly the compact, token-saving view agents use. The default human page is intentionally free of dense agent internals (those live in `diagnostics.html` in the Wikifier source for technical users). If an old diagnostics.html is present, it can be safely deleted. The .md files + MCP/CLI/tools remain the primary SSOT and update mechanism for agents. This layer lets humans (or teams) visually investigate and copy-paste wiki summaries for their own work / LLM chats without touching agent behavior or adding deps.
+**Human investigation layer (secondary, opt-in)**: `wikifier init` copies only `index.html` (the clean human wiki viewer) into the target project (the folder where MCP/CLI run). `diagnostics.html` (Wikifier maintainer hub) is no longer copied — it would show the wrong tree (Wikifier's internals) and be stale for the host project. Humans run `wikifier serve` and open http://localhost:8787/index.html (browsers block file:// fetches, so a double-clicked index.html shows an empty map — the page itself now detects this and shows the fix) to see a clean visual of *that project's* agent-maintained wiki: prominent code structure / dependency chart (Mermaid) as the hero, followed by a simple "Files & descriptions" list (paths + short "what this file is about" summaries pulled from the wiki notes), and a lightweight "Browse by folder" tree derived from the health data. A "Quick actions" toolbar provides one-click copy buttons for the main commands (check-changes, update-maps, monitor &); empty states ("No structure map yet", "No files in the wiki yet") have prominent primary buttons for first-time commands (update-maps prioritized, combined check-changes+update-maps for files). On first open with no map, the `wikifier update-maps` command is auto-copied (sessionStorage-guarded one-time per browser session) and live-wait mode is immediately activated. Buttons use copy + live-wait: they copy the exact command and inject a fixed top "Waiting for `wikifier ...` to produce data... (auto-polling)" banner with aggressive 3s polling that auto-detects when library.md / file_health.* update (from the terminal run) and refreshes the chart/files automatically; includes an "I ran it — refresh now" link in the banner and a success toast on detection. A short explanatory note in the UI clarifies the model: this is a pure static zero-dep viewer (browser JS cannot execute host shell commands due to security sandbox); the auto we provide is copy + immediate live-wait + fast poll so results (trees, files, descriptions) appear automatically after the user pastes/runs in their terminal. "Good enough" acceptance recorded for this copy+live-wait UX. Prominent copy buttons also export "structure as text" (Mermaid source) and a clean full snapshot (tree + file list + descriptions) — exactly the compact, token-saving view agents use. The default human page is intentionally free of dense agent internals (those live in `diagnostics.html` in the Wikifier source for technical users). If an old diagnostics.html is present, it can be safely deleted. The .md files + MCP/CLI/tools remain the primary SSOT and update mechanism for agents. This layer lets humans (or teams) visually investigate and copy-paste wiki summaries for their own work / LLM chats without touching agent behavior or adding deps.

{wikifier-4.3.0 → wikifier-4.3.2}/wikifier/__init__.py

@@ -61,4 +61,4 @@ from .contracts import (
     compute_acs_confidence,
 )
 
-__version__ = "4.3.0"
+__version__ = "4.3.2"

{wikifier-4.3.0 → wikifier-4.3.2}/wikifier/index.html

@@ -5,7 +5,26 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Project Wiki</title>
     <script src="https://cdn.tailwindcss.com"></script>
-    <script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
+    <!-- Version PINNED: the bare mermaid@10 alias let the CDN serve different
+         minors with different config schemas (maxEdges top-level vs nested
+         under flowchart), making large-graph rendering nondeterministic. -->
+    <script src="https://cdn.jsdelivr.net/npm/mermaid@10.9.3/dist/mermaid.min.js"></script>
+    <script>
+        // Configure Mermaid ONCE, immediately:
+        // - startOnLoad:false — the default auto-start processes .mermaid
+        //   elements at page load with default config, racing the explicit
+        //   render in loadMermaid().
+        // - maxEdges in BOTH placements — builds differ on where they read it
+        //   (top-level is also a "secure" key, so it must be set here via
+        //   initialize, never via in-diagram directives). Default 500 broke
+        //   every repo whose graph used the generator's 600-edge budget.
+        if (window.mermaid) mermaid.initialize({
+            startOnLoad: false,
+            theme: 'dark',
+            maxEdges: 1500,
+            flowchart: { maxEdges: 1500 }
+        });
+    </script>
     <style>
         @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&amp;family=Space+Grotesk:wght@500;600&amp;display=swap');
         
@@ -161,7 +180,10 @@
                             class="text-xs px-3 py-1.5 rounded-xl bg-emerald-900/30 hover:bg-emerald-900/50 text-emerald-400 border border-emerald-800">Rebuild tree</button>
                 </div>
                 <div id="mermaid-container" class="bg-slate-950 border border-slate-800 rounded-2xl p-5 min-h-[340px]">
-                    <div id="mermaid-diagram" class="mermaid"></div>
+                    <!-- NOTE: no class="mermaid" here — that class marks
+                         auto-start targets; the render target is the inner
+                         <pre class="mermaid"> created by loadMermaid(). -->
+                    <div id="mermaid-diagram"></div>
                 </div>
                 <div class="mt-4 flex flex-wrap gap-x-3 gap-y-2">
                     <button onclick="copyMermaidSource()" 
@@ -593,12 +615,31 @@
 
             const match = md.match(/```mermaid\n([\s\S]*?)```/);
             if (match && match[1]) {
-                container.innerHTML = `<pre class="mermaid">${match[1]}</pre>`;
+                // textContent (not template-in-innerHTML) so the Mermaid source
+                // can never be interpreted as HTML.
+                container.innerHTML = '<pre class="mermaid"></pre>';
+                container.querySelector('.mermaid').textContent = match[1];
                 if (window.mermaid) {
                     try {
-                        mermaid.initialize({ startOnLoad: false, theme: 'dark' });
+                        // Re-assert the same config as the early <head> init
+                        // (some builds re-read it per render; keep both maxEdges
+                        // placements — see the comment at the script tag).
+                        mermaid.initialize({
+                            startOnLoad: false,
+                            theme: 'dark',
+                            maxEdges: 1500,
+                            flowchart: { maxEdges: 1500 }
+                        });
                         await mermaid.run({ nodes: [container.querySelector('.mermaid')] });
-                    } catch(e) { /* ignore render err */ }
+                    } catch(e) {
+                        // Never fail silently: show what broke + how to inspect.
+                        const msg = (e && (e.message || e.str)) || String(e);
+                        container.innerHTML = `<div class="text-sm p-4 bg-slate-900 border border-amber-700 rounded">
+                            <div class="font-semibold mb-1 text-amber-400">Structure map could not be rendered</div>
+                            <div class="text-slate-300 text-xs font-mono">${String(msg).replace(/[<>&]/g, c => ({'<':'&lt;','>':'&gt;','&':'&amp;'}[c])).slice(0, 300)}</div>
+                            <div class="mt-2 text-[11px] text-slate-400">The underlying map data in <span class="font-mono">library.md</span> is intact — use "Copy structure as text" or open library.md directly.</div>
+                        </div>`;
+                    }
                 }
             } else {
                 container.innerHTML = `<div class="text-xs text-slate-400 p-4">No Mermaid diagram found in library.md.<br>Run <span class="font-mono text-emerald-400">wikifier update-maps</span> then refresh.</div>`;
@@ -770,9 +811,44 @@ Open index.html in the project for the live visual version.
         }
 
         // Boot: only what the human view needs (chart + files+descs + tree + monitor). Poll for live feel.
+        // Browsers refuse fetch() from file:// pages (unique-origin sandbox),
+        // so a double-clicked index.html can never read the wiki artifacts —
+        // the map stays empty while the console fills with CORS errors. Show
+        // the one-command fix prominently instead of failing silently.
+        function showFileProtocolNotice() {
+            const div = document.createElement('div');
+            div.id = 'file-protocol-notice';
+            div.style.cssText = 'position:sticky;top:0;z-index:60;background:#7c2d12;color:#ffedd5;padding:14px 18px;font-size:14px;line-height:1.6;box-shadow:0 2px 8px rgba(0,0,0,.4)';
+            div.innerHTML = '<strong>The dashboard cannot read the wiki files when opened directly from disk.</strong><br>' +
+                'Browsers block <code>fetch()</code> on <code>file://</code> pages (security sandbox), so the map and file list would stay empty. ' +
+                'Serve this folder over localhost instead — run one of these in the project folder, then open the link:' +
+                '<div style="margin-top:8px;display:flex;gap:8px;flex-wrap:wrap;align-items:center">' +
+                '<button id="fpCopyServe" style="background:#10b981;color:#06281e;border:none;border-radius:6px;padding:6px 12px;font-weight:600;cursor:pointer">Copy: wikifier serve</button>' +
+                '<button id="fpCopyPy" style="background:#374151;color:#e5e7eb;border:none;border-radius:6px;padding:6px 12px;cursor:pointer">Copy: python3 -m http.server 8787</button>' +
+                '<a href="http://localhost:8787/index.html" style="color:#5eead4;text-decoration:underline">open http://localhost:8787/index.html</a>' +
+                '</div>';
+            document.body.prepend(div);
+            const wire = (id, text) => {
+                const b = document.getElementById(id);
+                if (!b) return;
+                b.onclick = () => navigator.clipboard.writeText(text).then(() => {
+                    const old = b.textContent;
+                    b.textContent = 'Copied ✓';
+                    setTimeout(() => { b.textContent = old; }, 1600);
+                });
+            };
+            wire('fpCopyServe', 'wikifier serve');
+            wire('fpCopyPy', 'python3 -m http.server 8787');
+        }
+
         function boot() {
             initTailwind();
 
+            if (location.protocol === 'file:') {
+                showFileProtocolNotice();
+                return; // skip data loads + polling: every fetch would fail
+            }
+
             loadHealthMatrix();
             loadMermaid();
             loadMonitorStatus();

{wikifier-4.3.0 → wikifier-4.3.2}/wikifier/scripts/wikifier.ps1

@@ -84,6 +84,7 @@ Core:
   mark-green <file>
   health
   monitor
+  serve [port]
   update-maps
   init
 
@@ -160,6 +161,13 @@ dist
             Start-Sleep -Seconds 30
         }
     }
+    "serve" {
+        # Browsers block fetch() on file:// pages, so index.html must be served.
+        $port = if ($Arguments -and $Arguments[0]) { $Arguments[0] } else { "8787" }
+        Write-Log "Serving $WikifierRoot at http://localhost:$port/index.html (Ctrl+C to stop)"
+        Set-Location $WikifierRoot
+        python -m http.server $port --bind 127.0.0.1
+    }
     default {
         Write-Err "Unknown command '$Command'. Try 'wikifier help'."
     }

{wikifier-4.3.0 → wikifier-4.3.2}/wikifier/scripts/wikifier.sh

@@ -258,6 +258,9 @@ Core Commands:
   update-maps                Rebuild library.md with import/dependency Mermaid graph.
   validate                   Check that every monitored file has at least a stub wiki entry.
   monitor                    Background heartbeat: runs check-changes every 30s forever.
+  serve [port]               Serve the project folder on localhost (default 8787) so the
+                             index.html dashboard can read the wiki files (browsers block
+                             file:// fetches — do not double-click index.html).
   daemon <start|stop|status|logs|restart|run|install-service|uninstall-service>
                              Long-running daemon for continuous health matrix + dependency freshness.
                              Survives laptop sleep/lid close via wake detection. Supports systemd user service.
@@ -493,6 +496,20 @@ cmd_monitor() {
     done
 }
 
+cmd_serve() {
+    # Serve the project folder over localhost so the human dashboard
+    # (index.html) can fetch the wiki artifacts. Browsers block fetch() on
+    # file:// pages, so a double-clicked index.html always shows an empty map
+    # — the dashboard itself now explains this and points here.
+    local port="${1:-8787}"
+    if ! command -v python3 >/dev/null 2>&1; then
+        error "serve requires python3 (uses the stdlib http.server)."
+        return 1
+    fi
+    log "Serving $PROJECT_ROOT at http://localhost:$port/index.html  (Ctrl+C to stop)"
+    ( cd "$PROJECT_ROOT" && exec python3 -m http.server "$port" --bind 127.0.0.1 )
+}
+
 cmd_update_maps() {
     # Thin delegation (the long-stated "shell becomes thin" goal): the full
     # pipeline — dirty detection, in-process parsing, canonical cache persist,
@@ -694,7 +711,7 @@ EOT
 
     log "✅ Wikifier initialised in $target_dir . Edit monitored_paths.txt to point at your real codebase (or subdirs for monorepos)."
     log "   Recommended: export WIKIFIER_PROJECT_ROOT=$target_dir  (or cd there and use ./wikifier.sh)"
-    log "   Human layer: open index.html in browser for this project's code structure chart + files + descriptions (auto-refreshes with monitor). Use the copy buttons for clean text exports (tree + snapshot) to LLMs or teammates."
+    log "   Human layer: run 'wikifier serve' and open http://localhost:8787/index.html for this project's code structure chart + files + descriptions (browsers block file:// fetches, so don't double-click index.html — the page will tell you the same). Use the copy buttons for clean text exports (tree + snapshot) to LLMs or teammates."
 }
 
 cmd_cycles() {
@@ -804,6 +821,7 @@ main() {
         prepare-edit)            cmd_prepare_edit "$@" ;;
         mark-green)              cmd_mark_green "$@" ;;
         monitor)                 cmd_monitor ;;
+        serve)                   cmd_serve "$@" ;;
         daemon)                  python3 -m wikifier.daemon "$@" ;;
         update-maps)             cmd_update_maps "$@" ;;
         validate)                cmd_validate ;;

{wikifier-4.3.0 → wikifier-4.3.2/wikifier.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wikifier
-Version: 4.3.0
+Version: 4.3.2
 Summary: Zero-dependency agent-to-agent codebase wiki for LLMs and AI agents. Autonomously maintained via record-change and mark-green for token-efficient lookup of files, dependencies, health, and summaries — across tiny scripts to 50k+ monorepos. Optional MCP server with rich tools for agents.
 Author-email: Aron Amos <aron@example.com>
 Maintainer: Aron Amos
@@ -137,7 +137,7 @@ Works with Claude Desktop, Claude Code, Cursor, Cline, and any Model Context Pro
 
 ## The Human Layer (Secondary, by Design)
 
-`wikifier init` copies a single static `index.html` into your project: a read-only dashboard showing the Mermaid code-structure chart, files with short descriptions, and a folder browser — useful for humans investigating what the agents know. Command buttons copy the exact CLI command and live-poll for results (a static page can't execute shell commands — that's the browser sandbox working as intended). The agent-facing markdown files and tools remain the single source of truth.
+`wikifier init` copies a single static `index.html` into your project: a read-only dashboard showing the Mermaid code-structure chart, files with short descriptions, and a folder browser — useful for humans investigating what the agents know. View it with **`wikifier serve`** (then open http://localhost:8787/index.html) — browsers block `file://` fetches, so a double-clicked index.html can't read the wiki files; the page detects that case and shows you the fix. Command buttons copy the exact CLI command and live-poll for results (a static page can't execute shell commands — that's the browser sandbox working as intended). The agent-facing markdown files and tools remain the single source of truth.
 
 ## Intended Use: Strictly Agent-to-Agent