wikifier 4.3.0__tar.gz → 4.3.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wikifier
-Version: 4.3.0
+Version: 4.3.1
 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.1}/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.1}/index.html

@@ -770,9 +770,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.1}/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.1}/wikifier/__init__.py

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

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

@@ -770,9 +770,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.1}/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.1}/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.1/wikifier.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wikifier
-Version: 4.3.0
+Version: 4.3.1
 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