npm - superacli - Versions diffs - 1.1.7 → 1.1.8 - Mend

superacli 1.1.7 → 1.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/CONTRIBUTING.md +270 -0
package/README.md +64 -1
package/__tests__/adapter-schema.test.js +251 -86
package/__tests__/resend-plugin.test.js +109 -82
package/cli/adapters/process.js +1 -5
package/cli/plugins-manager.js +3 -3
package/cli/supercli.js +193 -77
package/docs/index.html +183 -123
package/index.html +384 -0
package/package.json +2 -2
package/plugins/plugins.json +11 -0
package/docs/docs.html +0 -224

package/index.html ADDED Viewed

@@ -0,0 +1,384 @@
+<!doctype html>
+<html lang="en" class="bg-slate-950">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>supercli — Universal Skill Router</title>
+    <script src="https://cdn.tailwindcss.com?plugins=typography"></script>
+    <script>
+      tailwind.config = {
+        theme: {
+          extend: {
+            fontFamily: {
+              display: ["Space Grotesk", "sans-serif"],
+              body: ["Inter", "sans-serif"],
+            },
+            colors: {
+              brand: {
+                50: "#ECF8FF",
+                200: "#A5D8FF",
+                400: "#38BDF8",
+                500: "#0891B2",
+                900: "#0F172A",
+              },
+            },
+          },
+        },
+      };
+    </script>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;600&family=Inter:wght@400;500;600&display=swap"
+      rel="stylesheet"
+    />
+    <link
+      rel="stylesheet"
+      href="https://cdn.jsdelivr.net/npm/daisyui@4.7.2/dist/full.min.css"
+    />
+    <style>
+      body {
+        font-family:
+          "Inter",
+          system-ui,
+          -apple-system,
+          BlinkMacSystemFont,
+          "Segoe UI",
+          sans-serif;
+        background:
+          radial-gradient(
+            circle at top,
+            rgba(8, 145, 178, 0.24),
+            rgba(15, 23, 42, 0.95)
+          ),
+          #020617;
+      }
+      .hero-grid {
+        background: linear-gradient(
+          135deg,
+          rgba(56, 189, 248, 0.08),
+          rgba(8, 145, 178, 0.08)
+        );
+        border: 1px solid rgba(56, 189, 248, 0.3);
+      }
+    </style>
+  </head>
+  <body class="text-slate-100">
+    <header class="max-w-6xl mx-auto px-6 py-12 md:py-16">
+      <div class="flex flex-col gap-6 text-center">
+        <div
+          class="inline-flex items-center justify-center gap-2 text-xs uppercase tracking-[0.3em] text-brand-200"
+        >
+          <span class="h-px w-8 bg-brand-200/60"></span>
+          Universal Skill Router
+          <span class="h-px w-8 bg-brand-200/60"></span>
+        </div>
+        <h1
+          class="text-4xl md:text-5xl font-display font-semibold leading-tight"
+        >
+          supercli — unify every CLI, API, and MCP tool as discoverable skills.
+        </h1>
+         <p class="text-lg md:text-xl text-slate-300 max-w-3xl mx-auto">
+           Build a universal skill layer for your agents. supercli automatically
+           exposes CLIs, OpenAPI endpoints, MCP servers, HTTP integrations, and
+           workflows as structured skills so agents can discover, search, and
+           execute capabilities through one interface.
+         </p>
+         <p class="text-sm md:text-base text-slate-400 max-w-3xl mx-auto">
+           Get started with <code>supercli help</code> or see all options with <code>supercli --help</code>
+         </p>
+        <div class="flex flex-wrap justify-center gap-4">
+          <a
+            class="btn btn-primary px-6"
+            href="./docs/index.html#getting-started"
+            >Start Building</a
+          >
+          <a
+            class="btn btn-outline border-brand-400/50 text-brand-200 px-6"
+            href="./docs/index.html"
+            >Explore the Docs</a
+          >
+          <a
+            class="btn btn-ghost text-slate-300 px-6"
+            href="https://github.com/javimosch/supercli"
+            target="_blank"
+            rel="noreferrer"
+            >GitHub Repo</a
+          >
+        </div>
+      </div>
+    </header>
+    <main class="max-w-6xl mx-auto px-6 pb-20 space-y-20">
+      <section class="grid gap-6 md:grid-cols-2 hero-grid rounded-3xl p-8">
+        <div class="space-y-4">
+          <p class="text-sm uppercase tracking-widest text-brand-200">
+            Skill Discovery Layer
+          </p>
+          <h2 class="text-3xl font-display font-semibold">
+            Agents query a single skill graph.
+          </h2>
+          <p class="text-slate-300">
+            supercli caches schemas, inputs, outputs, and rules for every
+            harness. Agents explore skills via search, inspect action metadata,
+            and trust consistent envelopes and exit codes.
+          </p>
+        </div>
+        <div class="space-y-3">
+          <div class="card bg-slate-900/60 border border-slate-700">
+            <div class="card-body">
+              <p class="text-xs uppercase tracking-widest text-brand-200">
+                Example
+              </p>
+              <pre
+                class="text-sm bg-slate-950/70 p-4 rounded-xl overflow-x-auto"
+              ><code>supercli skills search "database"
+supercli skills get beads.issue.create
+supercli plan beads issue create --title "Task"</code></pre>
+            </div>
+          </div>
+        </div>
+      </section>
+      <section class="space-y-10">
+        <div class="space-y-3">
+          <p class="text-sm uppercase tracking-widest text-brand-200">
+            Skill Sources
+          </p>
+          <h2 class="text-3xl font-display font-semibold">
+            Every tool becomes a skill.
+          </h2>
+          <p class="text-slate-300 max-w-3xl">
+            supercli ingests multiple ecosystems so the router stays agnostic to
+            execution details.
+          </p>
+        </div>
+        <div class="grid gap-5 md:grid-cols-3">
+          <article
+            class="p-6 rounded-2xl border border-slate-800 bg-slate-900/50"
+          >
+            <h3 class="text-xl font-semibold">CLI Harnesses</h3>
+            <p class="text-slate-400">
+              Route commands for beads, gwc, commiat, docker, kubectl, gh, aws,
+              terraform, and more via manifests or passthrough adapters.
+            </p>
+          </article>
+          <article
+            class="p-6 rounded-2xl border border-slate-800 bg-slate-900/50"
+          >
+            <h3 class="text-xl font-semibold">OpenAPI & HTTP</h3>
+            <p class="text-slate-400">
+              Import specs, auto-generate skills, and let agents execute
+              normalized HTTP requests with schema validation.
+            </p>
+          </article>
+          <article
+            class="p-6 rounded-2xl border border-slate-800 bg-slate-900/50"
+          >
+            <h3 class="text-xl font-semibold">MCP + Workflows</h3>
+            <p class="text-slate-400">
+              Expose MCP tools, AI-driven plans, and declarative workflows as
+              first-class skills with consistent envelopes.
+            </p>
+          </article>
+        </div>
+      </section>
+      <section class="grid gap-10 md:grid-cols-2 items-center">
+        <div class="order-2 md:order-1">
+          <p class="text-sm uppercase tracking-widest text-brand-200">
+            Architecture
+          </p>
+          <h2 class="text-3xl font-display font-semibold mb-4">
+            From agent request to tool execution.
+          </h2>
+          <p class="text-slate-300 mb-2">
+            Skills flow through a discovery layer, router, and harness/adapters
+            that target CLIs, APIs, or custom runtimes.
+          </p>
+          <pre
+            class="bg-slate-900 border border-slate-800 rounded-2xl p-6 text-sm leading-relaxed overflow-x-auto"
+          ><code>Agent → Skill Discovery → Router → Harness / Adapter → Tool</code></pre>
+        </div>
+        <div class="order-1 md:order-2">
+          <div class="rounded-3xl border border-slate-800 p-6 bg-slate-900/40">
+            <ul class="space-y-4 text-slate-300">
+              <li>
+                <span class="font-semibold text-slate-100">Discovery</span> –
+                catalog every skill with metadata & policy.
+              </li>
+              <li>
+                <span class="font-semibold text-slate-100">Routing</span> –
+                resolve namespaces to adapters automatically.
+              </li>
+              <li>
+                <span class="font-semibold text-slate-100">Execution</span> –
+                normalize inputs/outputs and exit codes.
+              </li>
+              <li>
+                <span class="font-semibold text-slate-100">Extension</span> –
+                drop in new harnesses, plugins, or specs.
+              </li>
+            </ul>
+          </div>
+        </div>
+      </section>
+      <section class="space-y-6">
+        <div
+          class="flex items-center gap-3 text-brand-200 text-sm uppercase tracking-widest"
+        >
+          <span class="h-px w-10 bg-brand-200/60"></span>
+          Skill Mesh Vision
+        </div>
+        <div class="grid gap-5 md:grid-cols-2">
+          <article
+            class="p-6 rounded-2xl border border-slate-800 bg-slate-900/60"
+          >
+            <h3 class="text-2xl font-display mb-3">
+              Toward a universal skill mesh.
+            </h3>
+            <p class="text-slate-300">
+              supercli is growing into a mesh that handles discovery, routing,
+              execution, composition, and governance for every capability in
+              your environment.
+            </p>
+          </article>
+          <article
+            class="p-6 rounded-2xl border border-slate-800 bg-slate-900/60"
+          >
+            <ul class="list-disc list-inside text-slate-300 space-y-2">
+              <li>Graph-native discovery & tagging</li>
+              <li>Execution DAG observability</li>
+              <li>Agent-facing HTTP/WebSocket endpoints</li>
+              <li>Policy controls across harnesses</li>
+            </ul>
+          </article>
+        </div>
+        <p class="text-sm text-slate-400">
+          Follow along in the docs for upcoming mesh capabilities and long-term
+          direction.
+        </p>
+      </section>
+      <section class="space-y-10">
+        <div class="space-y-3">
+          <p class="text-sm uppercase tracking-widest text-brand-200">
+            Plugin Explorer
+          </p>
+          <h2 class="text-3xl font-display font-semibold">
+            Discover and search plugins
+          </h2>
+          <p class="text-slate-300 max-w-2xl">
+            Browse the official supercli plugins that add new skills, wrappers,
+            and integrations to your agent toolkit.
+          </p>
+        </div>
+        <div class="space-y-4">
+          <div
+            class="flex flex-col md:flex-row md:items-start md:justify-between"
+          >
+            <label for="plugin-search" class="block mb-2 text-slate-300"
+              >Search plugins</label
+            >
+            <input
+              type="text"
+              id="plugin-search"
+              placeholder="Search by name, tag, or description"
+              class="input input-bordered w-full md:w-64"
+            />
+          </div>
+          <div
+            id="plugin-list"
+            class="grid gap-4 md:grid-cols-2 lg:grid-cols-3"
+          >
+            <!-- Plugin cards will be inserted here by JavaScript -->
+          </div>
+        </div>
+      </section>
+    </main>
+    <footer
+      class="border-t border-slate-800/60 py-8 text-center text-sm text-slate-400"
+    >
+      <a href="https://www.linkedin.com/in/arancibiajav/" target="_blank">
+        <p>© <span id="year"></span> by Javier Leandro Arancibia</p>
+      </a>
+      <div class="flex justify-center gap-4 mt-3">
+        <a class="underline" href="./docs/index.html#getting-started">Start</a>
+        <a class="underline" href="./docs/index.html">Docs</a>
+        <a class="underline" href="./docs/index.html#skill-vision"
+          >Skill vision</a
+        >
+      </div>
+    </footer>
+    <script>
+      document.getElementById("year").textContent = new Date().getFullYear();
+    </script>
+    <script>
+      // Plugin Explorer Script
+      document.addEventListener("DOMContentLoaded", function () {
+        const pluginList = document.getElementById("plugin-list");
+        const searchInput = document.getElementById("plugin-search");
+        // Fetch the plugins manifest
+        fetch("plugins/plugins.json")
+          .then((response) => {
+            if (!response.ok) {
+              throw new Error("Failed to fetch plugins");
+            }
+            return response.json();
+          })
+          .then((data) => {
+            const plugins = data.plugins;
+            renderPlugins(plugins);
+            // Add event listener for search
+            searchInput.addEventListener("input", (e) => {
+              const query = e.target.value.toLowerCase();
+              const filtered = plugins.filter(
+                (plugin) =>
+                  plugin.name.toLowerCase().includes(query) ||
+                  plugin.description.toLowerCase().includes(query) ||
+                  (plugin.tags || []).some((tag) =>
+                    tag.toLowerCase().includes(query),
+                  ),
+              );
+              renderPlugins(filtered);
+            });
+          })
+          .catch((error) => {
+            pluginList.innerHTML = `<p class="text-slate-400 col-span-3">Error loading plugins: ${error.message}</p>`;
+          });
+        function renderPlugins(plugins) {
+          if (plugins.length === 0) {
+            pluginList.innerHTML = `<p class="text-slate-400 col-span-3">No plugins found.</p>`;
+            return;
+          }
+          pluginList.innerHTML = plugins
+            .map((plugin) => {
+              const tagsHtml = (plugin.tags || [])
+                .map(
+                  (tag) => `<span class="badge badge-secondary">${tag}</span>`,
+                )
+                .join("");
+              return `
+              <article class="p-6 rounded-2xl border border-slate-800 bg-slate-900/50">
+                <h3 class="text-xl font-semibold">${plugin.name}</h3>
+                <p class="text-slate-400">${plugin.description}</p>
+                <div class="flex flex-wrap gap-2 mt-3">${tagsHtml}</div>
+              </article>
+            `;
+            })
+            .join("");
+        }
+      });
+    </script>
+  </body>
+</html>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "superacli",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Config-driven, AI-friendly dynamic CLI",
   "license": "MIT",
   "main": "server/app.js",
@@ -9,7 +9,7 @@
     "scli": "./cli/supercli.js",
     "superacli": "./cli/supercli.js",
     "supercli": "./cli/supercli.js",
-    "sc":"./cli/supercli.js"
+    "sc": "./cli/supercli.js"
   },
   "scripts": {
     "start": "node server/app.js",

package/plugins/plugins.json CHANGED Viewed

@@ -337,6 +337,17 @@
         "manifest_path": "plugins/supercli/plugin.json"
       }
     },
+    {
+      "name": "pdf-read",
+      "description": "Agent-friendly CLI for PDF text extraction with OCR fallback",
+      "tags": ["pdf", "ocr", "text-extraction", "agent-friendly"],
+      "source": {
+        "type": "git",
+        "repo": "https://github.com/javimosch/pdf-read.git",
+        "ref": "master",
+        "manifest_path": "plugins/supercli/plugin.json"
+      }
+    },
     {
       "name": "agency-agents",
       "description": "Indexes remote skills from msitarzewski/agency-agents into skills catalog",

package/docs/docs.html DELETED Viewed

@@ -1,224 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>supercli Documentation</title>
-    <script src="https://cdn.tailwindcss.com?plugins=typography"></script>
-    <script>
-      tailwind.config = {
-        theme: {
-          extend: {
-            fontFamily: {
-              sans: ['Inter', 'system-ui', 'sans-serif'],
-              display: ['Space Grotesk', 'sans-serif']
-            },
-            colors: {
-              brand: {
-                100: '#E0F2FE',
-                200: '#BAE6FD',
-                400: '#38BDF8',
-                500: '#0891B2'
-              }
-            }
-          }
-        }
-      };
-    </script>
-    <link rel="preconnect" href="https://fonts.googleapis.com" />
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-    <link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@500;600&family=Inter:wght@400;500;600&display=swap" rel="stylesheet" />
-    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/daisyui@4.7.2/dist/full.min.css" />
-    <style>
-      body {
-        font-family: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-        background-color: #020617;
-        color: #e2e8f0;
-      }
-      .sidebar-link {
-        transition: background-color 0.2s ease, color 0.2s ease;
-      }
-    </style>
-  </head>
-  <body class="bg-slate-950">
-    <div class="flex min-h-screen">
-      <aside id="sidebar" class="w-72 flex-shrink-0 border-r border-slate-800 bg-slate-950/80 backdrop-blur hidden lg:block">
-        <div class="p-6 space-y-8">
-          <div>
-            <p class="text-xs uppercase tracking-[0.4em] text-brand-400">Docs</p>
-            <h1 class="text-2xl font-display font-semibold mt-3 text-white">supercli</h1>
-            <p class="text-sm text-slate-400">Universal Skill Router</p>
-          </div>
-          <nav class="space-y-4">
-            <div>
-              <p class="text-xs uppercase tracking-widest text-slate-500 mb-2">Overview</p>
-              <ul class="space-y-2 text-sm">
-                <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#getting-started">Getting Started</a></li>
-                <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#skill-layer">Skill Layer Basics</a></li>
-                <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#skill-sources">Skill Sources</a></li>
-              </ul>
-            </div>
-            <div>
-              <p class="text-xs uppercase tracking-widest text-slate-500 mb-2">Runtime</p>
-              <ul class="space-y-2 text-sm">
-                <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#architecture">Architecture</a></li>
-                <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#cli-usage">CLI Usage</a></li>
-                <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#plugins">Plugins & Harnesses</a></li>
-              </ul>
-            </div>
-            <div>
-              <p class="text-xs uppercase tracking-widest text-slate-500 mb-2">Vision</p>
-              <ul class="space-y-2 text-sm">
-                <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#skill-vision">Skill Mesh Vision</a></li>
-                <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#resources">Resources</a></li>
-              </ul>
-            </div>
-          </nav>
-        </div>
-      </aside>
-      <div class="flex-1 flex flex-col">
-        <header class="border-b border-slate-800 px-6 py-4 flex items-center justify-between">
-          <button id="mobileToggle" class="lg:hidden btn btn-sm btn-outline border-brand-400 text-brand-100" type="button">Menu</button>
-          <div>
-            <p class="text-xs uppercase tracking-[0.4em] text-brand-400">Documentation</p>
-            <h1 class="text-2xl font-display font-semibold text-white">supercli Knowledge Base</h1>
-          </div>
-        </header>
-        <main class="flex-1 overflow-y-auto">
-          <section class="border-b border-slate-900 bg-slate-900/60 px-6 py-6">
-            <div class="max-w-4xl">
-              <p class="text-sm uppercase tracking-widest text-brand-200">Quick filter</p>
-              <input id="filterInput" type="text" placeholder="Search anything (e.g. OpenAPI, plugins, plans)" class="mt-3 w-full rounded-2xl bg-slate-950/70 border border-slate-700 px-4 py-3 text-slate-100 placeholder:text-slate-500 focus:border-brand-400 focus:outline-none" />
-            </div>
-          </section>
-          <div class="max-w-4xl px-6 py-10 space-y-10">
-            <article class="doc-section space-y-4" id="getting-started" data-keywords="install npm start quick start env">
-              <p class="text-sm uppercase tracking-widest text-brand-200">Start here</p>
-              <h2 class="text-3xl font-display font-semibold">Getting Started</h2>
-              <p class="text-slate-300">Run `npx supercli help` for instant usage, install dependencies with `npm install`, copy `.env.example`, and start the local server via `npm start` or `supercli --server`. The web UI (EJS + Vue + Tailwind) is reachable at `http://localhost:3000`. Refer to the repository README for additional context.</p>
-            </article>
-            <article class="doc-section space-y-4" id="skill-layer" data-keywords="skill layer discovery routing execution mesh">
-              <p class="text-sm uppercase tracking-widest text-brand-200">Concept</p>
-              <h2 class="text-3xl font-display font-semibold">Skill Layer Basics</h2>
-              <p class="text-slate-300">Every capability becomes a skill, whether it originates from CLI commands, OpenAPI endpoints, MCP tools, workflows, or HTTP requests. supercli indexes names like `namespace.resource.action`, exposes schemas, and lets agents discover, inspect, and execute consistently.</p>
-              <pre class="bg-slate-900 border border-slate-800 rounded-2xl p-4 text-sm"><code>supercli skills list
-supercli skills search "database"
-supercli skills get beads.issue.create</code></pre>
-            </article>
-            <article class="doc-section space-y-4" id="skill-sources" data-keywords="bundled adapters openapi http mcp workflows plugins">
-              <p class="text-sm uppercase tracking-widest text-brand-200">Sources</p>
-              <h2 class="text-3xl font-display font-semibold">Skill Sources</h2>
-              <ul class="list-disc list-inside text-slate-300 space-y-2">
-                <li><strong>Bundled Harnesses</strong> – beads, gwc, commiat ship with the CLI.</li>
-                <li><strong>Built-in Adapters</strong> – OpenAPI specs, raw HTTP, and MCP servers become skills automatically.</li>
-                <li><strong>Plugins</strong> – Install docker, gh, aws, kubectl, terraform harnesses via `supercli plugins install`.</li>
-                <li><strong>AI Plans / Workflows</strong> – Natural language `ask` and `plan` commands create DAGs of skills.</li>
-              </ul>
-            </article>
-            <article class="doc-section space-y-4" id="architecture" data-keywords="router discovery layer adapters harness diagram">
-              <p class="text-sm uppercase tracking-widest text-brand-200">Runtime</p>
-              <h2 class="text-3xl font-display font-semibold">Architecture</h2>
-              <p class="text-slate-300">Agents route requests through the skill discovery layer, which maps namespaces to harnesses/adapters. Execution envelopes guarantee deterministic JSON responses and exit codes.</p>
-              <pre class="bg-slate-900 border border-slate-800 rounded-2xl p-4 text-sm"><code>Agents/Humans → supercli runtime → Skill Router → Harness / Adapter → Tool</code></pre>
-            </article>
-            <article class="doc-section space-y-4" id="cli-usage" data-keywords="cli usage beads gwc docker plan ask plugins config">
-              <p class="text-sm uppercase tracking-widest text-brand-200">Interface</p>
-              <h2 class="text-3xl font-display font-semibold">CLI Usage</h2>
-              <div class="space-y-3">
-                <pre class="bg-slate-900 border border-slate-800 rounded-2xl p-4 text-sm"><code>supercli &lt;harness&gt;                # list skills
-supercli beads issue list --json
-supercli skills search --harness beads "task"
-supercli ask "deploy staging"
-supercli plugins explore --tags git,ai</code></pre>
-                <p class="text-slate-300">`--json`, `--human`, and `--compact` control output, while exit codes communicate validation, resource, or integration errors.</p>
-              </div>
-            </article>
-            <article class="doc-section space-y-4" id="plugins" data-keywords="plugin harness guide manifest commiat docker install">
-              <p class="text-sm uppercase tracking-widest text-brand-200">Extension</p>
-              <h2 class="text-3xl font-display font-semibold">Plugins & Harnesses</h2>
-              <p class="text-slate-300">Wrap any CLI with a `plugin.json` manifest that defines commands, schemas, dependency checks, and passthrough rules. Install from the registry, Git repos, or local paths.</p>
-              <p class="text-slate-400 text-sm">Need more? Check `docs/plugin-harness-guide.md` in the repository for step-by-step authoring details.</p>
-            </article>
-            <article class="doc-section space-y-4" id="skill-vision" data-keywords="skill mesh registry graph governance dag api telemetry">
-              <p class="text-sm uppercase tracking-widest text-brand-200">Vision</p>
-              <h2 class="text-3xl font-display font-semibold">Skill Mesh Direction</h2>
-              <p class="text-slate-300">The platform is evolving toward a mesh that handles discovery, routing, execution, composition, and governance. Key areas under exploration include a unified skill registry, graph-native discovery, mesh-wide policy, DAG orchestration, agent endpoints, composition tooling, telemetry, and richer plugin UX.</p>
-            </article>
-            <article class="doc-section space-y-4" id="resources" data-keywords="readme docs skills catalog supported harnesses">
-              <p class="text-sm uppercase tracking-widest text-brand-200">Resources</p>
-              <h2 class="text-3xl font-display font-semibold">More Documentation</h2>
-              <ul class="list-disc list-inside text-slate-300 space-y-2">
-                <li>README.md (repository root)</li>
-                <li>docs/skills-catalog.md</li>
-                <li>docs/supported-harnesses.md</li>
-                <li>docs/features/skills.md</li>
-              </ul>
-            </article>
-          </div>
-        </main>
-      </div>
-    </div>
-    <div id="mobileDrawer" class="fixed inset-0 bg-black/60 hidden z-40 lg:hidden">
-      <div class="w-72 bg-slate-950 h-full border-r border-slate-800 p-6 overflow-y-auto">
-        <div class="flex items-center justify-between mb-6">
-          <h2 class="text-white text-xl font-display">Navigate</h2>
-          <button id="drawerClose" class="btn btn-sm btn-ghost">Close</button>
-        </div>
-        <div id="drawerNav" class="space-y-6 text-sm">
-          <!-- Populated from sidebar -->
-        </div>
-      </div>
-    </div>
-    <script>
-      const filterInput = document.getElementById('filterInput');
-      const sections = document.querySelectorAll('.doc-section');
-      filterInput.addEventListener('input', (event) => {
-        const query = event.target.value.trim().toLowerCase();
-        sections.forEach((section) => {
-          const text = section.textContent.toLowerCase();
-          const keywords = section.dataset.keywords || '';
-          const match = text.includes(query) || keywords.includes(query);
-          section.style.display = match ? 'block' : 'none';
-        });
-      });
-      const sidebar = document.getElementById('sidebar');
-      const mobileDrawer = document.getElementById('mobileDrawer');
-      const drawerNav = document.getElementById('drawerNav');
-      const mobileToggle = document.getElementById('mobileToggle');
-      const drawerClose = document.getElementById('drawerClose');
-      const cloneSidebarNav = () => {
-        if (!sidebar) return;
-        drawerNav.innerHTML = sidebar.querySelector('nav').innerHTML;
-      };
-      cloneSidebarNav();
-      const openDrawer = () => {
-        mobileDrawer.classList.remove('hidden');
-      };
-      const closeDrawer = () => {
-        mobileDrawer.classList.add('hidden');
-      };
-      mobileToggle.addEventListener('click', openDrawer);
-      drawerClose.addEventListener('click', closeDrawer);
-      mobileDrawer.addEventListener('click', (event) => {
-        if (event.target === mobileDrawer) closeDrawer();
-      });
-    </script>
-  </body>
-</html>