@chrismo/superkit 1.0.0

package/LICENSE.txt

@@ -0,0 +1,29 @@
+BSD-3-Clause License
+
+Copyright (c) 2025, Chris Morris and contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,26 @@
+# SuperKit
+
+Documentation, tutorials, and recipes for [SuperDB](https://superdb.org/).
+
+**Website:** [chrismo.github.io/superkit](https://chrismo.github.io/superkit/)
+
+## Content
+
+- **Expert Guide** — Comprehensive SuperSQL syntax reference
+- **Upgrade Guide** — Migration guide from zq to SuperDB
+- **Tutorials** — Step-by-step guides for common patterns
+
+## How it works
+
+Content is authored in [superdb-mcp](https://github.com/chrismo/superdb-mcp) and auto-synced here via GitHub Action. The site is built with Jekyll using the [Just the Docs](https://just-the-docs.com/) theme and deployed via GitHub Pages.
+
+`changelog.jsup` is kept for historical reference from the original SuperKit project.
+
+## License
+
+SuperKit is licensed under the [BSD-3-Clause License](LICENSE.txt).
+
+SuperKit is an independent project that documents and provides recipes for
+[SuperDB](https://github.com/brimdata/super), which is licensed under the
+[SuperDB Source Available License](https://github.com/brimdata/super/blob/main/LICENSE.md).
+SuperKit does not distribute SuperDB source code or binaries.

package/dist/cli/pager.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pipe text through $PAGER (defaults to `less -FRX`).
+ * Falls back to stdout if no pager available or not a TTY.
+ */
+export declare function pager(text: string): void;
+//# sourceMappingURL=pager.d.ts.map

package/dist/cli/pager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pager.d.ts","sourceRoot":"","sources":["../../src/cli/pager.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAcxC"}

package/dist/cli/pager.js

@@ -0,0 +1,21 @@
+import { spawnSync } from 'child_process';
+import { writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+/**
+ * Pipe text through $PAGER (defaults to `less -FRX`).
+ * Falls back to stdout if no pager available or not a TTY.
+ */
+export function pager(text) {
+    if (!process.stdout.isTTY) {
+        process.stdout.write(text);
+        return;
+    }
+    const pagerCmd = process.env.PAGER || 'less';
+    const args = pagerCmd === 'less' ? ['-FRX'] : [];
+    // Write to a temp file so the pager can seek
+    const tmp = join(tmpdir(), `skdoc-${process.pid}.txt`);
+    writeFileSync(tmp, text);
+    spawnSync(pagerCmd, [...args, tmp], { stdio: 'inherit' });
+}
+//# sourceMappingURL=pager.js.map

package/dist/cli/pager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pager.js","sourceRoot":"","sources":["../../src/cli/pager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC;IAC7C,MAAM,IAAI,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjD,6CAA6C;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACvD,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEzB,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/cli/skdoc.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=skdoc.d.ts.map

package/dist/cli/skdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skdoc.d.ts","sourceRoot":"","sources":["../../src/cli/skdoc.ts"],"names":[],"mappings":""}

package/dist/cli/skdoc.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { superHelp } from '../lib/help.js';
+import { pager } from './pager.js';
+const topic = process.argv[2];
+if (!topic) {
+    const result = superHelp('expert');
+    if (!result.success) {
+        console.error(result.error);
+        process.exit(1);
+    }
+    const lines = [
+        'SuperKit Documentation Browser',
+        '',
+        'Usage: skdoc <topic>',
+        '',
+        'Topics:',
+        '  expert              Expert guide overview (sections listed below)',
+        '  expert:all          Full expert guide',
+        '  expert:<section>    Specific expert section',
+        '  upgrade             SuperDB upgrade/migration guide',
+        '  tutorials           List available tutorials',
+        '  tutorial:<name>     Specific tutorial',
+        '',
+    ];
+    if (result.sections) {
+        lines.push('Expert guide sections:');
+        for (const s of result.sections) {
+            lines.push(`  expert:${s.slug.padEnd(24)} ${s.title}`);
+        }
+        lines.push('');
+    }
+    pager(lines.join('\n'));
+}
+else {
+    const result = superHelp(topic);
+    if (!result.success) {
+        console.error(result.error);
+        process.exit(1);
+    }
+    pager(result.content);
+}
+//# sourceMappingURL=skdoc.js.map

package/dist/cli/skdoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skdoc.js","sourceRoot":"","sources":["../../src/cli/skdoc.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE9B,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,gCAAgC;QAChC,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,SAAS;QACT,qEAAqE;QACrE,yCAAyC;QACzC,+CAA+C;QAC/C,uDAAuD;QACvD,gDAAgD;QAChD,yCAAyC;QACzC,EAAE;KACH,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1B,CAAC;KAAM,CAAC;IACN,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC"}

package/dist/cli/skgrok.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=skgrok.d.ts.map

package/dist/cli/skgrok.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skgrok.d.ts","sourceRoot":"","sources":["../../src/cli/skgrok.ts"],"names":[],"mappings":""}

package/dist/cli/skgrok.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { superGrokPatterns } from '../lib/grok.js';
+import { pager } from './pager.js';
+const query = process.argv[2];
+const result = superGrokPatterns(query);
+if (!result.success) {
+    console.error(result.error);
+    process.exit(1);
+}
+if (result.count === 0) {
+    console.error(query ? `No grok patterns matching "${query}"` : 'No grok patterns found');
+    process.exit(1);
+}
+const maxName = Math.max(...result.patterns.map(p => p.pattern_name.length));
+const lines = result.patterns.map(p => {
+    const name = p.pattern_name.padEnd(maxName + 2);
+    const regex = p.regex.length > 80 ? p.regex.slice(0, 77) + '...' : p.regex;
+    return `${name}${regex}`;
+});
+pager(lines.join('\n') + '\n');
+//# sourceMappingURL=skgrok.js.map

package/dist/cli/skgrok.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skgrok.js","sourceRoot":"","sources":["../../src/cli/skgrok.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9B,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAExC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,8BAA8B,KAAK,GAAG,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;IACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;IACpC,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3E,OAAO,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC"}

package/dist/cli/skops.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=skops.d.ts.map

package/dist/cli/skops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skops.d.ts","sourceRoot":"","sources":["../../src/cli/skops.ts"],"names":[],"mappings":""}

package/dist/cli/skops.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { superRecipes } from '../lib/recipes.js';
+import { pager } from './pager.js';
+const query = process.argv[2];
+const result = superRecipes(query);
+if (!result.success) {
+    console.error(result.error);
+    process.exit(1);
+}
+if (result.count === 0) {
+    console.error(query ? `No recipes matching "${query}"` : 'No recipes found');
+    process.exit(1);
+}
+const lines = [];
+for (const r of result.recipes) {
+    const argStr = r.args.length > 0
+        ? r.args.map(a => a.name).join(', ')
+        : '';
+    const sig = r.type === 'op'
+        ? `op ${r.name} ${argStr}`
+        : `${r.name}(${argStr})`;
+    lines.push(`${sig}`);
+    lines.push(`  ${r.description}`);
+    if (r.examples.length > 0) {
+        for (const ex of r.examples) {
+            lines.push(`  ${ex.i} => ${ex.o}`);
+        }
+    }
+    lines.push('');
+}
+pager(lines.join('\n'));
+//# sourceMappingURL=skops.js.map

package/dist/cli/skops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skops.js","sourceRoot":"","sources":["../../src/cli/skops.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;AAEnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,KAAK,GAAa,EAAE,CAAC;AAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAC9B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACpC,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI;QACzB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,MAAM,EAAE;QAC1B,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,GAAG,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAEjC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjB,CAAC;AAED,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { getDocsDir, getRecipeFiles } from './lib/docs.js';
+export { superHelp } from './lib/help.js';
+export type { HelpResult } from './lib/help.js';
+export { getExpertDoc, buildOverview, parseExpertDoc, clearExpertCache, SECTION_SLUGS } from './lib/expert-sections.js';
+export type { ExpertSection, ParsedExpertDoc } from './lib/expert-sections.js';
+export { superGrokPatterns } from './lib/grok.js';
+export type { GrokPattern, GrokPatternsResult } from './lib/grok.js';
+export { superRecipes } from './lib/recipes.js';
+export type { RecipeFunction, RecipeArg, RecipeExample, RecipesResult } from './lib/recipes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxH,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Content resolution
+export { getDocsDir, getRecipeFiles } from './lib/docs.js';
+// Help / documentation
+export { superHelp } from './lib/help.js';
+// Expert guide sections
+export { getExpertDoc, buildOverview, parseExpertDoc, clearExpertCache, SECTION_SLUGS } from './lib/expert-sections.js';
+// Grok patterns
+export { superGrokPatterns } from './lib/grok.js';
+// Recipes
+export { superRecipes } from './lib/recipes.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3D,uBAAuB;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGxH,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/lib/docs.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve the docs/ directory path.
+ * Works whether superkit is installed globally (CLI) or in node_modules (MCP dependency).
+ */
+export declare function getDocsDir(): string;
+/**
+ * Get paths to all recipe .spq files.
+ * Useful for building -I flags when wrapping the super binary.
+ */
+export declare function getRecipeFiles(): string[];
+//# sourceMappingURL=docs.d.ts.map

package/dist/lib/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/lib/docs.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAUzC"}

package/dist/lib/docs.js

@@ -0,0 +1,29 @@
+import { readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Resolve the docs/ directory path.
+ * Works whether superkit is installed globally (CLI) or in node_modules (MCP dependency).
+ */
+export function getDocsDir() {
+    return join(__dirname, '../../docs');
+}
+/**
+ * Get paths to all recipe .spq files.
+ * Useful for building -I flags when wrapping the super binary.
+ */
+export function getRecipeFiles() {
+    const recipesDir = join(getDocsDir(), 'recipes');
+    try {
+        return readdirSync(recipesDir)
+            .filter(f => f.endsWith('.spq'))
+            .sort()
+            .map(f => join(recipesDir, f));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=docs.js.map

package/dist/lib/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/lib/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,UAAU,CAAC;aAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;aAC/B,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/lib/expert-sections.d.ts

@@ -0,0 +1,32 @@
+export interface ExpertSection {
+    slug: string;
+    title: string;
+    content: string;
+    lines: number;
+}
+export interface ParsedExpertDoc {
+    preamble: string;
+    sections: ExpertSection[];
+}
+/**
+ * Explicit slug map for intuitive, stable slugs.
+ * Keys are the exact ## heading text (without the ## prefix).
+ */
+export declare const SECTION_SLUGS: Record<string, string>;
+/**
+ * Parse the expert markdown into preamble + sections split on ## headings.
+ */
+export declare function parseExpertDoc(markdown: string): ParsedExpertDoc;
+/**
+ * Build the overview: preamble + inline sections (warning, core) + section index table.
+ */
+export declare function buildOverview(doc: ParsedExpertDoc): string;
+/**
+ * Get the parsed expert doc, lazily reading and caching the file.
+ */
+export declare function getExpertDoc(): ParsedExpertDoc;
+/**
+ * Clear the cached expert doc (for tests).
+ */
+export declare function clearExpertCache(): void;
+//# sourceMappingURL=expert-sections.d.ts.map

package/dist/lib/expert-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expert-sections.d.ts","sourceRoot":"","sources":["../../src/lib/expert-sections.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAchD,CAAC;AAyBF;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAqChE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA0B1D;AAKD;;GAEG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAO9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/lib/expert-sections.js

@@ -0,0 +1,130 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { getDocsDir } from './docs.js';
+/**
+ * Explicit slug map for intuitive, stable slugs.
+ * Keys are the exact ## heading text (without the ## prefix).
+ */
+export const SECTION_SLUGS = {
+    'Note on Zed/zq Compatibility': 'warning',
+    'Core Knowledge': 'core',
+    'Language Syntax Reference': 'syntax',
+    'PostgreSQL Compatibility & Traditional SQL': 'sql',
+    'Practical Query Patterns': 'patterns',
+    'Advanced SuperDB Features': 'advanced',
+    'Debugging Tips': 'debugging',
+    'Format Conversions': 'formats',
+    'Key Differences from SQL': 'differences',
+    'Pragmas': 'pragmas',
+    'SuperDB Quoting Rules (Bash Integration)': 'quoting',
+    'SuperDB Array Filtering (Critical Pattern)': 'arrays',
+    'Aggregate Functions': 'aggregates',
+};
+/** Slugs that are always included inline in the overview. */
+const OVERVIEW_SLUGS = ['warning', 'core'];
+/**
+ * Generate a slug from a heading by lowercasing and replacing non-alphanumeric runs with hyphens.
+ */
+function autoSlug(heading) {
+    return heading
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Strip YAML frontmatter (--- delimited) from markdown content.
+ */
+function stripFrontmatter(markdown) {
+    if (!markdown.startsWith('---'))
+        return markdown;
+    const endIdx = markdown.indexOf('---', 3);
+    if (endIdx === -1)
+        return markdown;
+    return markdown.slice(endIdx + 3).replace(/^\n+/, '');
+}
+/**
+ * Parse the expert markdown into preamble + sections split on ## headings.
+ */
+export function parseExpertDoc(markdown) {
+    const stripped = stripFrontmatter(markdown);
+    const lines = stripped.split('\n');
+    let preamble = '';
+    const sections = [];
+    let currentTitle = null;
+    let currentLines = [];
+    for (const line of lines) {
+        const match = line.match(/^## (.+)$/);
+        if (match) {
+            if (currentTitle !== null) {
+                const content = currentLines.join('\n').trim();
+                const title = currentTitle;
+                const slug = SECTION_SLUGS[title] ?? autoSlug(title);
+                sections.push({ slug, title, content: `## ${title}\n\n${content}`, lines: content.split('\n').length });
+            }
+            else {
+                preamble = currentLines.join('\n').trim();
+            }
+            currentTitle = match[1];
+            currentLines = [];
+        }
+        else {
+            currentLines.push(line);
+        }
+    }
+    if (currentTitle !== null) {
+        const content = currentLines.join('\n').trim();
+        const title = currentTitle;
+        const slug = SECTION_SLUGS[title] ?? autoSlug(title);
+        sections.push({ slug, title, content: `## ${title}\n\n${content}`, lines: content.split('\n').length });
+    }
+    else {
+        preamble = currentLines.join('\n').trim();
+    }
+    return { preamble, sections };
+}
+/**
+ * Build the overview: preamble + inline sections (warning, core) + section index table.
+ */
+export function buildOverview(doc) {
+    const parts = [];
+    if (doc.preamble) {
+        parts.push(doc.preamble);
+    }
+    for (const slug of OVERVIEW_SLUGS) {
+        const section = doc.sections.find(s => s.slug === slug);
+        if (section) {
+            parts.push(section.content);
+        }
+    }
+    const remaining = doc.sections.filter(s => !OVERVIEW_SLUGS.includes(s.slug));
+    if (remaining.length > 0) {
+        parts.push('## Available Sections\n');
+        parts.push('Use `super_help` with topic `"expert:<slug>"` to read a specific section.\n');
+        parts.push('| Slug | Section | Lines |');
+        parts.push('|---|---|---|');
+        for (const section of remaining) {
+            parts.push(`| \`expert:${section.slug}\` | ${section.title} | ${section.lines} |`);
+        }
+    }
+    return parts.join('\n\n');
+}
+// Lazy-cached parsed doc
+let cachedDoc = null;
+/**
+ * Get the parsed expert doc, lazily reading and caching the file.
+ */
+export function getExpertDoc() {
+    if (!cachedDoc) {
+        const filepath = join(getDocsDir(), 'superdb-expert.md');
+        const markdown = readFileSync(filepath, 'utf-8');
+        cachedDoc = parseExpertDoc(markdown);
+    }
+    return cachedDoc;
+}
+/**
+ * Clear the cached expert doc (for tests).
+ */
+export function clearExpertCache() {
+    cachedDoc = null;
+}
+//# sourceMappingURL=expert-sections.js.map

package/dist/lib/expert-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expert-sections.js","sourceRoot":"","sources":["../../src/lib/expert-sections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAcvC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,8BAA8B,EAAE,SAAS;IACzC,gBAAgB,EAAE,MAAM;IACxB,2BAA2B,EAAE,QAAQ;IACrC,4CAA4C,EAAE,KAAK;IACnD,0BAA0B,EAAE,UAAU;IACtC,2BAA2B,EAAE,UAAU;IACvC,gBAAgB,EAAE,WAAW;IAC7B,oBAAoB,EAAE,SAAS;IAC/B,0BAA0B,EAAE,aAAa;IACzC,SAAS,EAAE,SAAS;IACpB,0CAA0C,EAAE,SAAS;IACrD,4CAA4C,EAAE,QAAQ;IACtD,qBAAqB,EAAE,YAAY;CACpC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAE3C;;GAEG;AACH,SAAS,QAAQ,CAAC,OAAe;IAC/B,OAAO,OAAO;SACX,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1C,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnC,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,YAAY,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC/C,MAAM,KAAK,GAAG,YAAY,CAAC;gBAC3B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1G,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,CAAC;YACD,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,YAAY,GAAG,EAAE,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,YAAY,CAAC;QAC3B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1G,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAoB;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACxD,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;QAC1F,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,IAAI,QAAQ,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,yBAAyB;AACzB,IAAI,SAAS,GAA2B,IAAI,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,mBAAmB,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC"}

package/dist/lib/grok.d.ts

@@ -0,0 +1,15 @@
+export interface GrokPattern {
+    pattern_name: string;
+    regex: string;
+}
+export interface GrokPatternsResult {
+    success: boolean;
+    patterns: GrokPattern[];
+    count: number;
+    error: string | null;
+}
+/**
+ * Search/filter grok patterns by name or regex content.
+ */
+export declare function superGrokPatterns(query?: string): GrokPatternsResult;
+//# sourceMappingURL=grok.d.ts.map

package/dist/lib/grok.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok.d.ts","sourceRoot":"","sources":["../../src/lib/grok.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAuBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAkCpE"}

package/dist/lib/grok.js

@@ -0,0 +1,57 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { getDocsDir } from './docs.js';
+/**
+ * Parse the grok patterns .sup file into structured objects.
+ * Each line is a SUP record like: {pattern_name:"FOO",regex:"bar"}
+ */
+function loadGrokPatterns() {
+    const grokPatternsPath = join(getDocsDir(), 'grok-patterns.sup');
+    const content = readFileSync(grokPatternsPath, 'utf-8');
+    const lines = content.trim().split('\n').filter(Boolean);
+    return lines.map(line => {
+        const nameMatch = line.match(/pattern_name:"([^"]+)"/);
+        const regexMatch = line.match(/regex:"((?:[^"\\]|\\.)*)"/);
+        if (!nameMatch || !regexMatch) {
+            throw new Error(`Failed to parse grok pattern line: ${line}`);
+        }
+        return {
+            pattern_name: nameMatch[1],
+            regex: regexMatch[1],
+        };
+    });
+}
+/**
+ * Search/filter grok patterns by name or regex content.
+ */
+export function superGrokPatterns(query) {
+    try {
+        const allPatterns = loadGrokPatterns();
+        if (!query) {
+            return {
+                success: true,
+                patterns: allPatterns,
+                count: allPatterns.length,
+                error: null,
+            };
+        }
+        const q = query.toLowerCase();
+        const filtered = allPatterns.filter(p => p.pattern_name.toLowerCase().includes(q) ||
+            p.regex.toLowerCase().includes(q));
+        return {
+            success: true,
+            patterns: filtered,
+            count: filtered.length,
+            error: null,
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            patterns: [],
+            count: 0,
+            error: e instanceof Error ? e.message : String(e),
+        };
+    }
+}
+//# sourceMappingURL=grok.js.map

package/dist/lib/grok.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok.js","sourceRoot":"","sources":["../../src/lib/grok.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAcvC;;;GAGG;AACH,SAAS,gBAAgB;IACvB,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,OAAO;YACL,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;YAC1B,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;SACrB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,WAAW,CAAC,MAAM;gBACzB,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,CACF,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YACxC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CACpC,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;SAClD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/help.d.ts

@@ -0,0 +1,20 @@
+export interface HelpResult {
+    success: boolean;
+    topic: string;
+    content: string;
+    sections?: Array<{
+        slug: string;
+        title: string;
+        lines: number;
+    }>;
+    web_url?: string;
+    error: string | null;
+}
+/**
+ * Get help documentation by topic.
+ *
+ * Topics: expert, expert:all, expert:<slug>, upgrade, upgrade-guide, migration,
+ * tutorials, tutorial:<name>
+ */
+export declare function superHelp(topic: string): HelpResult;
+//# sourceMappingURL=help.d.ts.map

package/dist/lib/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/lib/help.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AA2BD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAwInD"}