superacli 1.1.7 → 1.1.9

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 (16) hide show
  1. package/CONTRIBUTING.md +270 -0
  2. package/README.md +64 -1
  3. package/__tests__/adapter-schema.test.js +251 -86
  4. package/__tests__/resend-plugin.test.js +109 -82
  5. package/cli/adapters/process.js +10 -5
  6. package/cli/plugins-manager.js +3 -3
  7. package/cli/skills-catalog.js +169 -10
  8. package/cli/skills.js +46 -3
  9. package/cli/supercli.js +214 -78
  10. package/docs/index.html +183 -123
  11. package/index.html +384 -0
  12. package/package.json +2 -2
  13. package/plugins/openhands/plugin.json +6 -6
  14. package/plugins/openhands/skills/quickstart/SKILL.md +23 -0
  15. package/plugins/plugins.json +11 -0
  16. package/docs/docs.html +0 -224
package/docs/docs.html DELETED
@@ -1,224 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8" />
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
- <title>supercli Documentation</title>
7
- <script src="https://cdn.tailwindcss.com?plugins=typography"></script>
8
- <script>
9
- tailwind.config = {
10
- theme: {
11
- extend: {
12
- fontFamily: {
13
- sans: ['Inter', 'system-ui', 'sans-serif'],
14
- display: ['Space Grotesk', 'sans-serif']
15
- },
16
- colors: {
17
- brand: {
18
- 100: '#E0F2FE',
19
- 200: '#BAE6FD',
20
- 400: '#38BDF8',
21
- 500: '#0891B2'
22
- }
23
- }
24
- }
25
- }
26
- };
27
- </script>
28
- <link rel="preconnect" href="https://fonts.googleapis.com" />
29
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
30
- <link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@500;600&family=Inter:wght@400;500;600&display=swap" rel="stylesheet" />
31
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/daisyui@4.7.2/dist/full.min.css" />
32
- <style>
33
- body {
34
- font-family: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
35
- background-color: #020617;
36
- color: #e2e8f0;
37
- }
38
- .sidebar-link {
39
- transition: background-color 0.2s ease, color 0.2s ease;
40
- }
41
- </style>
42
- </head>
43
- <body class="bg-slate-950">
44
- <div class="flex min-h-screen">
45
- <aside id="sidebar" class="w-72 flex-shrink-0 border-r border-slate-800 bg-slate-950/80 backdrop-blur hidden lg:block">
46
- <div class="p-6 space-y-8">
47
- <div>
48
- <p class="text-xs uppercase tracking-[0.4em] text-brand-400">Docs</p>
49
- <h1 class="text-2xl font-display font-semibold mt-3 text-white">supercli</h1>
50
- <p class="text-sm text-slate-400">Universal Skill Router</p>
51
- </div>
52
- <nav class="space-y-4">
53
- <div>
54
- <p class="text-xs uppercase tracking-widest text-slate-500 mb-2">Overview</p>
55
- <ul class="space-y-2 text-sm">
56
- <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>
57
- <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>
58
- <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>
59
- </ul>
60
- </div>
61
- <div>
62
- <p class="text-xs uppercase tracking-widest text-slate-500 mb-2">Runtime</p>
63
- <ul class="space-y-2 text-sm">
64
- <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>
65
- <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>
66
- <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>
67
- </ul>
68
- </div>
69
- <div>
70
- <p class="text-xs uppercase tracking-widest text-slate-500 mb-2">Vision</p>
71
- <ul class="space-y-2 text-sm">
72
- <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>
73
- <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>
74
- </ul>
75
- </div>
76
- </nav>
77
- </div>
78
- </aside>
79
-
80
- <div class="flex-1 flex flex-col">
81
- <header class="border-b border-slate-800 px-6 py-4 flex items-center justify-between">
82
- <button id="mobileToggle" class="lg:hidden btn btn-sm btn-outline border-brand-400 text-brand-100" type="button">Menu</button>
83
- <div>
84
- <p class="text-xs uppercase tracking-[0.4em] text-brand-400">Documentation</p>
85
- <h1 class="text-2xl font-display font-semibold text-white">supercli Knowledge Base</h1>
86
- </div>
87
- </header>
88
-
89
- <main class="flex-1 overflow-y-auto">
90
- <section class="border-b border-slate-900 bg-slate-900/60 px-6 py-6">
91
- <div class="max-w-4xl">
92
- <p class="text-sm uppercase tracking-widest text-brand-200">Quick filter</p>
93
- <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" />
94
- </div>
95
- </section>
96
-
97
- <div class="max-w-4xl px-6 py-10 space-y-10">
98
- <article class="doc-section space-y-4" id="getting-started" data-keywords="install npm start quick start env">
99
- <p class="text-sm uppercase tracking-widest text-brand-200">Start here</p>
100
- <h2 class="text-3xl font-display font-semibold">Getting Started</h2>
101
- <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>
102
- </article>
103
-
104
- <article class="doc-section space-y-4" id="skill-layer" data-keywords="skill layer discovery routing execution mesh">
105
- <p class="text-sm uppercase tracking-widest text-brand-200">Concept</p>
106
- <h2 class="text-3xl font-display font-semibold">Skill Layer Basics</h2>
107
- <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>
108
- <pre class="bg-slate-900 border border-slate-800 rounded-2xl p-4 text-sm"><code>supercli skills list
109
- supercli skills search "database"
110
- supercli skills get beads.issue.create</code></pre>
111
- </article>
112
-
113
- <article class="doc-section space-y-4" id="skill-sources" data-keywords="bundled adapters openapi http mcp workflows plugins">
114
- <p class="text-sm uppercase tracking-widest text-brand-200">Sources</p>
115
- <h2 class="text-3xl font-display font-semibold">Skill Sources</h2>
116
- <ul class="list-disc list-inside text-slate-300 space-y-2">
117
- <li><strong>Bundled Harnesses</strong> – beads, gwc, commiat ship with the CLI.</li>
118
- <li><strong>Built-in Adapters</strong> – OpenAPI specs, raw HTTP, and MCP servers become skills automatically.</li>
119
- <li><strong>Plugins</strong> – Install docker, gh, aws, kubectl, terraform harnesses via `supercli plugins install`.</li>
120
- <li><strong>AI Plans / Workflows</strong> – Natural language `ask` and `plan` commands create DAGs of skills.</li>
121
- </ul>
122
- </article>
123
-
124
- <article class="doc-section space-y-4" id="architecture" data-keywords="router discovery layer adapters harness diagram">
125
- <p class="text-sm uppercase tracking-widest text-brand-200">Runtime</p>
126
- <h2 class="text-3xl font-display font-semibold">Architecture</h2>
127
- <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>
128
- <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>
129
- </article>
130
-
131
- <article class="doc-section space-y-4" id="cli-usage" data-keywords="cli usage beads gwc docker plan ask plugins config">
132
- <p class="text-sm uppercase tracking-widest text-brand-200">Interface</p>
133
- <h2 class="text-3xl font-display font-semibold">CLI Usage</h2>
134
- <div class="space-y-3">
135
- <pre class="bg-slate-900 border border-slate-800 rounded-2xl p-4 text-sm"><code>supercli &lt;harness&gt; # list skills
136
- supercli beads issue list --json
137
- supercli skills search --harness beads "task"
138
- supercli ask "deploy staging"
139
- supercli plugins explore --tags git,ai</code></pre>
140
- <p class="text-slate-300">`--json`, `--human`, and `--compact` control output, while exit codes communicate validation, resource, or integration errors.</p>
141
- </div>
142
- </article>
143
-
144
- <article class="doc-section space-y-4" id="plugins" data-keywords="plugin harness guide manifest commiat docker install">
145
- <p class="text-sm uppercase tracking-widest text-brand-200">Extension</p>
146
- <h2 class="text-3xl font-display font-semibold">Plugins & Harnesses</h2>
147
- <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>
148
- <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>
149
- </article>
150
-
151
- <article class="doc-section space-y-4" id="skill-vision" data-keywords="skill mesh registry graph governance dag api telemetry">
152
- <p class="text-sm uppercase tracking-widest text-brand-200">Vision</p>
153
- <h2 class="text-3xl font-display font-semibold">Skill Mesh Direction</h2>
154
- <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>
155
- </article>
156
-
157
- <article class="doc-section space-y-4" id="resources" data-keywords="readme docs skills catalog supported harnesses">
158
- <p class="text-sm uppercase tracking-widest text-brand-200">Resources</p>
159
- <h2 class="text-3xl font-display font-semibold">More Documentation</h2>
160
- <ul class="list-disc list-inside text-slate-300 space-y-2">
161
- <li>README.md (repository root)</li>
162
- <li>docs/skills-catalog.md</li>
163
- <li>docs/supported-harnesses.md</li>
164
- <li>docs/features/skills.md</li>
165
- </ul>
166
- </article>
167
- </div>
168
- </main>
169
- </div>
170
- </div>
171
-
172
- <div id="mobileDrawer" class="fixed inset-0 bg-black/60 hidden z-40 lg:hidden">
173
- <div class="w-72 bg-slate-950 h-full border-r border-slate-800 p-6 overflow-y-auto">
174
- <div class="flex items-center justify-between mb-6">
175
- <h2 class="text-white text-xl font-display">Navigate</h2>
176
- <button id="drawerClose" class="btn btn-sm btn-ghost">Close</button>
177
- </div>
178
- <div id="drawerNav" class="space-y-6 text-sm">
179
- <!-- Populated from sidebar -->
180
- </div>
181
- </div>
182
- </div>
183
-
184
- <script>
185
- const filterInput = document.getElementById('filterInput');
186
- const sections = document.querySelectorAll('.doc-section');
187
-
188
- filterInput.addEventListener('input', (event) => {
189
- const query = event.target.value.trim().toLowerCase();
190
- sections.forEach((section) => {
191
- const text = section.textContent.toLowerCase();
192
- const keywords = section.dataset.keywords || '';
193
- const match = text.includes(query) || keywords.includes(query);
194
- section.style.display = match ? 'block' : 'none';
195
- });
196
- });
197
-
198
- const sidebar = document.getElementById('sidebar');
199
- const mobileDrawer = document.getElementById('mobileDrawer');
200
- const drawerNav = document.getElementById('drawerNav');
201
- const mobileToggle = document.getElementById('mobileToggle');
202
- const drawerClose = document.getElementById('drawerClose');
203
-
204
- const cloneSidebarNav = () => {
205
- if (!sidebar) return;
206
- drawerNav.innerHTML = sidebar.querySelector('nav').innerHTML;
207
- };
208
- cloneSidebarNav();
209
-
210
- const openDrawer = () => {
211
- mobileDrawer.classList.remove('hidden');
212
- };
213
- const closeDrawer = () => {
214
- mobileDrawer.classList.add('hidden');
215
- };
216
-
217
- mobileToggle.addEventListener('click', openDrawer);
218
- drawerClose.addEventListener('click', closeDrawer);
219
- mobileDrawer.addEventListener('click', (event) => {
220
- if (event.target === mobileDrawer) closeDrawer();
221
- });
222
- </script>
223
- </body>
224
- </html>