aboutsummaryrefslogtreecommitdiff
path: root/help.html
diff options
context:
space:
mode:
Diffstat (limited to 'help.html')
-rw-r--r--help.html64
1 files changed, 60 insertions, 4 deletions
diff --git a/help.html b/help.html
index 35baf8a..446de33 100644
--- a/help.html
+++ b/help.html
@@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="theme-color" content="#0a0a14">
-<title>WebX11 v4.5.24 — Help</title>
+<title>WebX11 v4.5.34 — Help</title>
<style>
/* ── Reset & Base ── */
*,*::before,*::after{box-sizing:border-box;margin:0;padding:0;-webkit-tap-highlight-color:transparent}
@@ -231,7 +231,7 @@ footer .tagline{color:var(--accent2);margin-top:10px;font-weight:500}
<h1>WebX11 <span>Docs</span></h1>
</div>
<div class="header-meta">
- <span class="badge badge-v">v4.5.22</span>
+ <span class="badge badge-v">v4.5.34</span>
<span class="badge badge-new">38 core · ext</span>
<span style="color:var(--text2)">160+ commands</span>
</div>
@@ -414,7 +414,7 @@ webx11.inputField // DOM input element</code></pre>
<!-- ── Overview ── -->
<section id="overview">
<h2>⛅ Overview</h2>
- <p>WebX11 v4.5.24 is a browser-based Unix-like terminal — dynamic modules, AI assistant (Ollama), persistent virtual filesystem, web search, voice input, code editor, and a full skill system. Everything runs client-side in your browser.</p>
+ <p>WebX11 v4.5.34 is a browser-based Unix-like terminal — dynamic modules, AI assistant (Ollama), persistent virtual filesystem, web search, voice input, code editor, and a full skill system. Everything runs client-side in your browser.</p>
<div class="feature-grid">
<div class="feature-card"><h4>🧩 18 Core + 14 Ext</h4><p>Modules loaded at startup. Shell with pipes, redirects, vars, and scripts.</p></div>
<div class="feature-card"><h4>🤖 Agent with Tools</h4><p>28 tools — file ops, web search, skills, modules. Destructive action confirmations with inline bar + countdown.</p></div>
@@ -524,6 +524,8 @@ diff a.txt b.txt</pre>
<tr><td><code>ai-compress</code></td><td>Manually compress conversation context</td><td><code>ai-compress</code></td></tr>
<tr><td><code>ai-config</code></td><td>View/set AI loop config (max-turns, max-context, max-context-tokens, confirm-timeout(0=disabled), chat-lock-timeout, skill-debounce, trivial-optimization)</td><td><code>ai-config max-turns 12</code></td></tr>
<tr><td><code>debug</code></td><td>Toggle AI debug mode</td><td><code>debug</code></td></tr>
+ <tr><td><code>mem-debug</code></td><td>Memory diagnostic (tool call log, heap, localStorage sizes)</td><td><code>mem-debug</code></td></tr>
+ <tr><td><code>reset-mem</code></td><td>Clear AI internal logs without touching VFS/config</td><td><code>reset-mem</code></td></tr>
</table></div>
<h3>Smart Context</h3>
@@ -846,6 +848,8 @@ ollamaconnect</pre>
<tr><td><code>listmods</code></td><td>List all loaded modules</td></tr>
<tr><td><code>load-local</code></td><td>Load module from VFS or URL</td></tr>
<tr><td><code>loadlocal</code></td><td>Alias for load-local</td></tr>
+ <tr><td><code>js &lt;expr&gt;</code></td><td>Evaluate JavaScript in page context</td></tr>
+ <tr><td><code>js-run &lt;path&gt;</code></td><td>Load and execute a JS file from VFS</td></tr>
<tr><td><code>startup-modules</code></td><td>Configure boot modules</td></tr>
</table></div>
@@ -983,6 +987,41 @@ floating-add panel info "Server: production | Uptime: 12d"
<span class="cmt"># Position persists across page reloads</span></pre>
</section>
+ <!-- ── Runtime Debug /sys/ ── -->
+ <section id="runtime-debug">
+ <h2>🔍 Runtime Debug — /sys/</h2>
+ <div class="callout callout-success">
+ <span class="callout-title">Virtual /sys/ filesystem</span>
+ Live runtime state mounted as browsable VFS files. Cat, grep, tree, find all work — no special commands needed. Never persisted to localStorage.
+ </div>
+ <h3>Path Reference</h3>
+ <pre><span class="cmt"># Overview</span>
+cat /sys/info
+
+<span class="cmt"># Memory</span>
+cat /sys/heap/stats
+cat /sys/heap/breakdown
+
+<span class="cmt"># AI Internal Logs</span>
+cat /sys/logs/tool-calls
+cat /sys/logs/errors
+cat /sys/logs/commands
+
+<span class="cmt"># VFS Stats</span>
+cat /sys/vfs/stats
+cat /sys/vfs/largest
+
+<span class="cmt"># Module Info</span>
+ls /sys/modules/
+cat /sys/modules/calc/info
+
+<span class="cmt"># DOM / Config</span>
+cat /sys/dom/node-count
+cat /sys/config/ai
+cat /sys/config/version</pre>
+ <p>Also available: <code>mem-debug</code> (one-shot text output) and <code>reset-mem</code> (clear AI internal logs without touching VFS or config).</p>
+ </section>
+
<!-- ── Shell ── -->
<section id="shell">
<h2>🐚 Shell</h2>
@@ -1256,6 +1295,7 @@ vfs-import</pre>
<tr><td><code>nvfs-config [key] [value]</code></td><td>View/set config (fuzzy-limit, tree-files, tree-concepts, resolve-files, deep-index, deep-model)</td></tr>
<tr><td><code>nvfs-alias list|add|remove|clear</code></td><td>Manage concept aliases</td></tr>
<tr><td><code>nvfs-sync [--deep]</code></td><td>Incremental background sync dirty files</td></tr>
+ <tr><td><code>nvfs-save</code></td><td>Force-save semantic index to VFS disk</td></tr>
</table></div>
</section>
@@ -1407,7 +1447,7 @@ listmods</pre>
<section id="ref">
<h2>⚡ Quick Reference</h2>
<div class="quick-ref">
- <div class="quick-ref-title">WebX11 v4.5.11</div>
+ <div class="quick-ref-title">WebX11 v4.5.34</div>
<div class="quick-ref-grid">
<div class="quick-ref-item"><span class="cmd">help</span><span class="desc">Show all commands</span></div>
<div class="quick-ref-item"><span class="cmd">cls</span><span class="desc">Clear terminal</span></div>
@@ -1438,6 +1478,9 @@ listmods</pre>
<div class="quick-ref-item"><span class="cmd">nvfs-index</span><span class="desc">Build semantic index</span></div>
<div class="quick-ref-item"><span class="cmd">nvfs-resolve</span><span class="desc">Find files by concept</span></div>
<div class="quick-ref-item"><span class="cmd">nvfs-sync</span><span class="desc">Sync dirty files</span></div>
+ <div class="quick-ref-item"><span class="cmd">nvfs-save</span><span class="desc">Save index to disk</span></div>
+ <div class="quick-ref-item"><span class="cmd">js</span><span class="desc">Eval JS expression</span></div>
+ <div class="quick-ref-item"><span class="cmd">js-run</span><span class="desc">Run JS file</span></div>
<div class="quick-ref-item"><span class="cmd">vfs-size</span><span class="desc">VFS size report</span></div>
<div class="quick-ref-item"><span class="cmd">vfs-clean</span><span class="desc">Nuke system dirs</span></div>
<div class="quick-ref-item"><span class="cmd">mindmap svg</span><span class="desc">Render mindmap as SVG</span></div>
@@ -1462,6 +1505,19 @@ listmods</pre>
<h2>📋 Changelog</h2>
<div class="version-item">
+ <div class="v-header"><span class="v-num">v4.5.34 — June 2026</span><span class="v-date">2026-06-10</span></div>
+ <ul>
+ <li><strong>NVFS deep index persistence</strong> — LLM-generated concepts now survive page refresh. <code>_processDeepQueue()</code> calls <code>_saveIndex()</code>. Deep concepts written to disk on completion.</li>
+ <li><strong>nvfs-save command</strong> — <code>nvfs-save</code> force-saves the semantic index to VFS disk immediately. Useful before hard refresh.</li>
+ <li><strong>Auto-sync deep mode</strong> — <code>nvfs-sync --deep</code> or <code>nvfs-config deep-index on</code> now triggers LLM analysis for dirty files, not just fast filename concepts.</li>
+ <li><strong>Safety guard</strong> — Running <code>nvfs-index</code> without <code>--deep</code> when saved index contains LLM concepts prints a warning: they'll be stripped from re-indexed files.</li>
+ <li><strong>JS Console module</strong> — New <code>js &lt;expression&gt;</code> command evals JavaScript in page context. <code>js-run &lt;path&gt;</code> loads and executes a VFS script file. Auto-loads at startup.</li>
+ <li><strong>Module registration</strong> — <code>console</code> added to packages.json, terminal.js ext loader, and skipList. Auto-loads on next refresh.</li>
+ <li>Cache: <code>2026-06-10-v4.5.34</code> — hard refresh required</li>
+ </ul>
+ </div>
+
+ <div class="version-item">
<div class="v-header"><span class="v-num">v4.5.24 — June 2026</span><span class="v-date">2026-06-08</span></div>
<ul>
<li><strong>tar / untar commands</strong> — New pure-JS tarball parser in cryptogzip.js. <code>tar &lt;src-dir&gt; &lt;out.tar[.gz]&gt;</code> bundles a VFS directory; <code>untar &lt;path.tar[.gz]&gt; [dest-dir]</code> extracts back. Auto-detects gzip wrapper. Fixes the "downloaded newos4.tar.gz but can't extract" problem.</li>