contentbase 0.4.0 → 0.4.2

package/dist/cli/commands/search.js

@@ -0,0 +1,212 @@
+import { z } from 'zod';
+import path from 'node:path';
+import { commands } from '../registry.js';
+import { loadCollection } from '../load-collection.js';
+import { collectDocumentInputs } from '../../search/document-inputs.js';
+import { getInitializedSemanticSearch, hasSearchIndex } from '../../search/luca-semantic-search.js';
+const argsSchema = z.object({
+    mode: z.enum(['hybrid', 'keyword', 'vector']).default('hybrid'),
+    model: z.string().optional(),
+    where: z.string().optional(),
+    n: z.number().default(10),
+    json: z.boolean().default(false),
+    full: z.boolean().default(false),
+    bootstrap: z.boolean().default(false),
+    contentFolder: z.string().optional(),
+});
+async function buildIndex(container, collection) {
+    const ss = await getInitializedSemanticSearch(container, collection.rootPath);
+    const docs = collectDocumentInputs(collection);
+    const toIndex = docs.filter((doc) => ss.needsReindex(doc));
+    ss.removeStale(docs.map((d) => d.pathId));
+    if (toIndex.length === 0) {
+        console.error('Index is up to date.');
+        return ss;
+    }
+    console.error(`Indexing ${toIndex.length} document(s)...`);
+    const batchSize = 5;
+    for (let i = 0; i < toIndex.length; i += batchSize) {
+        const batch = toIndex.slice(i, i + batchSize);
+        await ss.indexDocuments(batch);
+        console.error(`  ${Math.min(i + batchSize, toIndex.length)}/${toIndex.length}`);
+    }
+    console.error('Index ready.');
+    return ss;
+}
+async function handler(options, { container }) {
+    const ui = container.feature('ui');
+    const query = container.argv._[1];
+    if (!query) {
+        console.error('Usage: cnotes search <query> [options]');
+        console.error('  --mode          hybrid|keyword|vector (default: hybrid)');
+        console.error('  --model         Filter by model name');
+        console.error('  --where         Metadata filter, e.g. "status=approved"');
+        console.error('  -n              Max results (default: 10)');
+        console.error('  --json          Output as JSON');
+        console.error('  --full          Include full document content');
+        console.error('  --bootstrap     Build index if missing, then search');
+        process.exit(1);
+    }
+    const collection = await loadCollection({
+        contentFolder: options.contentFolder,
+    });
+    if (!hasSearchIndex(collection.rootPath) && !options.bootstrap) {
+        console.error('No search index found. Run: cnotes embed');
+        process.exit(1);
+    }
+    let ss;
+    if (options.bootstrap && !hasSearchIndex(collection.rootPath)) {
+        ss = await buildIndex(container, collection);
+    }
+    else {
+        ss = await getInitializedSemanticSearch(container, collection.rootPath);
+    }
+    // Parse where clause: "key=value,key2=value2"
+    let where;
+    if (options.where) {
+        where = {};
+        for (const pair of options.where.split(',')) {
+            const [key, ...rest] = pair.split('=');
+            if (key && rest.length > 0) {
+                where[key.trim()] = rest.join('=').trim();
+            }
+        }
+    }
+    const searchOptions = {
+        limit: options.n,
+        model: options.model,
+        where,
+    };
+    let results;
+    switch (options.mode) {
+        case 'keyword':
+            results = await ss.search(query, searchOptions);
+            break;
+        case 'vector':
+            results = await ss.vectorSearch(query, searchOptions);
+            break;
+        case 'hybrid':
+        default:
+            results = await ss.hybridSearch(query, searchOptions);
+            break;
+    }
+    if (options.json) {
+        if (options.full) {
+            for (const r of results) {
+                try {
+                    const doc = collection.document(r.pathId);
+                    r.content = doc.content;
+                }
+                catch { }
+            }
+        }
+        console.log(JSON.stringify(results, null, 2));
+        return;
+    }
+    if (results.length === 0) {
+        console.log('No results found.');
+        return;
+    }
+    const colors = ui.colors;
+    const cols = process.stdout.columns || 80;
+    const pad = '   ';
+    const maxSnippet = cols - pad.length - 2;
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        const title = r.title || r.pathId;
+        console.log(`${colors.dim(`${i + 1}.`)} ${colors.bold(title)}`);
+        let relPath = r.pathId;
+        try {
+            relPath = path.relative(process.cwd(), collection.document(r.pathId).path);
+        }
+        catch { }
+        console.log(`${pad}${colors.cyan(relPath)}`);
+        if (r.snippet) {
+            let snippet = r.snippet
+                .replace(/>>>/g, '').replace(/<<</g, '')
+                .replace(/\n/g, ' ').replace(/\s+/g, ' ')
+                .replace(/[`*_~\[\]]/g, '').trim();
+            if (r.matchedSection)
+                snippet = `${r.matchedSection} — ${snippet}`;
+            if (snippet.length > maxSnippet)
+                snippet = snippet.substring(0, maxSnippet - 1) + '…';
+            console.log(`${pad}${colors.dim(snippet)}`);
+        }
+        if (i < results.length - 1)
+            console.log();
+    }
+    if (options.full) {
+        for (const r of results) {
+            try {
+                const doc = collection.document(r.pathId);
+                console.log(ui.colors.cyan(`\n--- ${r.pathId} ---\n`));
+                console.log(doc.content);
+            }
+            catch { }
+        }
+    }
+}
+commands.register('search', {
+    description: 'Semantic search across collection documents',
+    usage: '<query>',
+    help: `# cnotes search
+
+Search documents in the collection using keyword, semantic, or hybrid search modes. Requires a search index — run \`cnotes embed\` first.
+
+## Usage
+
+\`\`\`
+cnotes search <query> [options]
+\`\`\`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| \`query\` | Search query text |
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| \`--mode\` | \`hybrid\` | Search mode: \`hybrid\`, \`keyword\`, or \`vector\` |
+| \`--model\` | | Filter results to a specific model |
+| \`--where\` | | Metadata filter (e.g. \`"status=approved"\`) |
+| \`-n\` | \`10\` | Maximum results to return |
+| \`--json\` | \`false\` | Output as JSON |
+| \`--full\` | \`false\` | Include full document content |
+| \`--bootstrap\` | \`false\` | Build index if missing, then search |
+| \`--contentFolder\` | | Path to content folder |
+
+## Examples
+
+\`\`\`bash
+# Hybrid search (default)
+cnotes search "authentication patterns"
+
+# Keyword-only search (BM25)
+cnotes search "deploymentConfig" --mode keyword
+
+# Semantic vector search
+cnotes search "how do deployments work" --mode vector
+
+# Filter by model
+cnotes search "auth" --model Epic
+
+# Filter by metadata
+cnotes search "approved plans" --where "status=approved"
+
+# Limit results
+cnotes search "auth" -n 20
+
+# JSON output
+cnotes search "auth" --json
+
+# Build index if missing, then search
+cnotes search "auth" --bootstrap
+\`\`\`
+`,
+    argsSchema,
+    handler,
+});
+//# sourceMappingURL=search.js.map

package/dist/cli/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/serve.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serve.d.ts.map

package/dist/cli/commands/serve.d.ts.map

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

package/dist/cli/commands/serve.js

@@ -0,0 +1,298 @@
+import { z } from 'zod';
+import path from 'node:path';
+import fs from 'node:fs';
+import { commands } from '../registry.js';
+import { loadCollection } from '../load-collection.js';
+import { buildSchemaJSON } from './api/helpers.js';
+import { builtinEndpoints } from './api/endpoints/index.js';
+import { collectDocumentInputs } from '../../search/document-inputs.js';
+import { getInitializedSemanticSearch, hasSearchIndex } from '../../search/luca-semantic-search.js';
+const argsSchema = z.object({
+    port: z.number().default(8000),
+    contentFolder: z.string().optional(),
+    modulePath: z.string().optional(),
+    endpointsDir: z.string().optional(),
+    staticDir: z.string().optional(),
+    cors: z.boolean().default(true),
+    force: z.boolean().default(false),
+    anyPort: z.boolean().default(false),
+    open: z.boolean().default(false),
+    readOnly: z.boolean().default(false),
+    refreshInterval: z.number().optional(),
+    watch: z.boolean().default(true),
+    search: z.boolean().default(false),
+});
+async function handler(options, context) {
+    const container = context.container;
+    const { networking, proc } = container;
+    // Resolve content folder from positional arg or option
+    const positionalFolder = container.argv._[1];
+    const contentFolder = positionalFolder || options.contentFolder || undefined;
+    const modulePath = options.modulePath || undefined;
+    const collection = await loadCollection({ contentFolder, modulePath });
+    const modelDefs = collection.modelDefinitions;
+    // Attach collection to container so endpoints can access it
+    container._contentbaseCollection = collection;
+    container._contentbaseReadOnly = options.readOnly;
+    // ---------------------------------------------------------------------------
+    // Port handling
+    // ---------------------------------------------------------------------------
+    let port = options.port;
+    if (options.anyPort) {
+        port = await networking.findOpenPort(port + 1);
+    }
+    const isPortAvailable = await networking.isPortOpen(port);
+    if (!isPortAvailable) {
+        if (!options.force) {
+            console.error(`Port ${port} is already in use.`);
+            console.error(`Use --force to kill the process on this port, or --any-port to find another port.`);
+            process.exit(1);
+        }
+        const pids = proc.findPidsByPort(port);
+        if (!pids.length) {
+            console.error(`Port ${port} is in use, but no PID could be discovered for termination.`);
+            process.exit(1);
+        }
+        for (const pid of pids) {
+            proc.kill(pid);
+        }
+        let portFreed = false;
+        for (let i = 0; i < 10; i++) {
+            if (await networking.isPortOpen(port)) {
+                portFreed = true;
+                break;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        if (!portFreed) {
+            console.error(`Failed to free port ${port} after terminating process(es): ${pids.join(', ')}`);
+            process.exit(1);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Static directory
+    // ---------------------------------------------------------------------------
+    const cwd = process.cwd();
+    const staticDir = options.staticDir ? path.resolve(cwd, options.staticDir) : path.resolve(cwd, 'public');
+    let resolvedStaticDir;
+    if (fs.existsSync(staticDir)) {
+        resolvedStaticDir = staticDir;
+    }
+    else if (fs.existsSync(path.resolve(cwd, 'index.html'))) {
+        resolvedStaticDir = cwd;
+    }
+    // ---------------------------------------------------------------------------
+    // User endpoints directory
+    // ---------------------------------------------------------------------------
+    let userEndpointsDir = null;
+    if (options.endpointsDir) {
+        const dir = path.resolve(cwd, options.endpointsDir);
+        if (fs.existsSync(dir))
+            userEndpointsDir = dir;
+    }
+    else {
+        for (const candidate of ['endpoints', 'src/endpoints']) {
+            const dir = path.resolve(cwd, candidate);
+            if (fs.existsSync(dir)) {
+                userEndpointsDir = dir;
+                break;
+            }
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Express server
+    // ---------------------------------------------------------------------------
+    const expressServer = container.server('express', {
+        port,
+        cors: options.cors,
+        static: resolvedStaticDir,
+        historyFallback: false,
+    });
+    // Load built-in contentbase endpoints (statically imported so they survive bun compile)
+    await expressServer.useEndpointModules(builtinEndpoints);
+    // Load user endpoints if present
+    if (userEndpointsDir) {
+        await expressServer.useEndpoints(userEndpointsDir);
+    }
+    // Redirect root to /docs/ table of contents when no static index.html exists
+    if (!resolvedStaticDir || !fs.existsSync(path.join(resolvedStaticDir, 'index.html'))) {
+        expressServer.app.get('/', (_req, res) => {
+            res.redirect('/docs/');
+        });
+    }
+    // OpenAPI spec
+    expressServer.serveOpenAPISpec({
+        title: 'Contentbase API',
+        version: '1.0.0',
+        description: `REST API for ${collection.rootPath}`,
+    });
+    await expressServer.start({ port });
+    // ---------------------------------------------------------------------------
+    // Startup summary
+    // ---------------------------------------------------------------------------
+    const schema = buildSchemaJSON(collection);
+    const modelNames = Object.keys(schema);
+    console.log(`\nContentbase server listening on http://localhost:${port}`);
+    console.log(`Collection: ${collection.rootPath}`);
+    console.log(`Models: ${modelNames.join(', ') || '(none)'}`);
+    console.log(`Documents: ${collection.available.length}`);
+    if (options.readOnly) {
+        console.log(`Mode: read-only (write endpoints disabled)`);
+    }
+    console.log(`OpenAPI spec: http://localhost:${port}/openapi.json`);
+    if (resolvedStaticDir) {
+        console.log(`Static files: ${resolvedStaticDir}`);
+    }
+    if (expressServer._mountedEndpoints?.length) {
+        console.log(`\nEndpoints:`);
+        for (const ep of expressServer._mountedEndpoints) {
+            console.log(`  ${ep.methods.map((m) => m.toUpperCase()).join(', ').padEnd(20)} ${ep.path}`);
+        }
+    }
+    console.log();
+    if (options.open) {
+        try {
+            const opener = container.feature('opener');
+            await opener.open(`http://localhost:${port}`);
+        }
+        catch (error) {
+            console.warn(`Could not open browser automatically: ${error.message}`);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Search index auto-update
+    // ---------------------------------------------------------------------------
+    if (options.search) {
+        if (hasSearchIndex(collection.rootPath)) {
+            try {
+                const ss = await getInitializedSemanticSearch(container, collection.rootPath);
+                const docs = collectDocumentInputs(collection);
+                const stale = docs.filter((d) => ss.needsReindex(d));
+                ss.removeStale(docs.map((d) => d.pathId));
+                if (stale.length > 0) {
+                    console.log(`[search] Updating ${stale.length} stale document(s)...`);
+                    await ss.indexDocuments(stale);
+                    console.log(`[search] Index updated.`);
+                }
+                else {
+                    console.log(`[search] Index is up to date.`);
+                }
+            }
+            catch (error) {
+                console.warn(`[search] Auto-index failed: ${error.message}`);
+            }
+        }
+        else {
+            console.log(`[search] No search index found. Run: cnotes embed`);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // File watching
+    // ---------------------------------------------------------------------------
+    if (options.watch !== false) {
+        const fileManager = container.feature('fileManager');
+        await fileManager.start({ rootPath: collection.rootPath });
+        await fileManager.watch();
+        const { debounce } = container.utils.lodash;
+        const refreshCollection = debounce(async () => {
+            try {
+                const before = collection.available.length;
+                await collection.load({ refresh: true });
+                const after = collection.available.length;
+                if (after !== before) {
+                    console.log(`[watch] Collection refreshed: ${before} → ${after} documents`);
+                }
+            }
+            catch (error) {
+                console.warn(`[watch] Refresh failed: ${error.message}`);
+            }
+        }, 500);
+        fileManager.on('file:change', (event) => {
+            if (/\.(md|mdx)$/i.test(event.path)) {
+                refreshCollection();
+            }
+        });
+        console.log(`Watching for file changes in ${collection.rootPath}`);
+    }
+    // ---------------------------------------------------------------------------
+    // Collection refresh interval (safety-net fallback)
+    // ---------------------------------------------------------------------------
+    const defaultInterval = container.isProduction ? 10 * 60 : 60; // seconds
+    const intervalSeconds = options.refreshInterval ?? defaultInterval;
+    setInterval(async () => {
+        try {
+            const before = collection.available.length;
+            await collection.load({ refresh: true });
+            const after = collection.available.length;
+            if (after !== before) {
+                console.log(`[refresh] Collection rescanned: ${before} → ${after} documents`);
+            }
+        }
+        catch (error) {
+            console.warn(`[refresh] Failed to rescan collection: ${error.message}`);
+        }
+    }, intervalSeconds * 1000);
+    console.log(`Refresh interval: every ${intervalSeconds}s`);
+}
+commands.register('serve', {
+    description: 'Start an HTTP server for the collection with REST API and document serving',
+    help: `# cnotes serve
+
+Start an HTTP server with REST API endpoints for querying, creating, updating, and deleting documents. Serves static files and auto-generates an OpenAPI spec.
+
+## Usage
+
+\`\`\`
+cnotes serve [contentFolder] [options]
+\`\`\`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| \`contentFolder\` | Path to content folder (positional or via \`--contentFolder\`) |
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| \`--port\` | \`8000\` | Port to listen on |
+| \`--force\` | \`false\` | Kill existing process on the port |
+| \`--anyPort\` | \`false\` | Find next available port if taken |
+| \`--open\` | \`false\` | Open browser after starting |
+| \`--readOnly\` | \`false\` | Disable write endpoints |
+| \`--cors\` | \`true\` | Enable CORS |
+| \`--staticDir\` | \`public/\` | Directory for static file serving |
+| \`--endpointsDir\` | auto | Directory for user endpoint modules |
+| \`--modulePath\` | | Path to collection entry module |
+| \`--refreshInterval\` | \`60\` | Seconds between collection rescans (fallback) |
+| \`--disable-watch\` | \`false\` | Disable file watching for automatic collection refresh |
+| \`--contentFolder\` | | Path to content folder |
+
+## User Endpoints
+
+Place endpoint modules in \`endpoints/\` or \`src/endpoints/\` and they'll be auto-mounted. Use \`--endpointsDir\` to override.
+
+## Examples
+
+\`\`\`bash
+# Start on default port
+cnotes serve
+
+# Serve a specific folder on a custom port
+cnotes serve ./docs --port 3000
+
+# Force kill existing server and open browser
+cnotes serve --port 8000 --force --open
+
+# Read-only mode for production
+cnotes serve --readOnly --port 8080
+
+# Find any available port
+cnotes serve --anyPort
+\`\`\`
+`,
+    argsSchema,
+    handler,
+});
+//# sourceMappingURL=serve.js.map

package/dist/cli/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/cli/commands/serve.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/summary.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=summary.d.ts.map

package/dist/cli/commands/summary.d.ts.map

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

package/dist/cli/commands/summary.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { commands } from '../registry.js';
+import { loadCollection } from '../load-collection.js';
+const argsSchema = z.object({
+    contentFolder: z.string().optional(),
+    includeIds: z.boolean().optional().default(false),
+});
+async function handler(options) {
+    const collection = await loadCollection({
+        contentFolder: options.contentFolder,
+    });
+    await collection.saveModelSummary({ includeIds: options.includeIds });
+    console.log(`README.md written to ${collection.rootPath}/README.md`);
+    const toc = collection.tableOfContents({ title: 'Table of Contents' });
+    const tocPath = join(collection.rootPath, 'TABLE-OF-CONTENTS.md');
+    await writeFile(tocPath, toc, 'utf-8');
+    console.log(`TABLE-OF-CONTENTS.md written to ${tocPath}`);
+}
+commands.register('summary', {
+    description: 'Generate README.md and TABLE-OF-CONTENTS.md for the collection',
+    help: `# cnotes summary
+
+Generate documentation files for the collection. Writes \`README.md\` (model definitions summary) and \`TABLE-OF-CONTENTS.md\` (document listing) to the content root.
+
+## Usage
+
+\`\`\`
+cnotes summary [options]
+\`\`\`
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| \`--contentFolder\` | Path to content folder |
+| \`--include-ids\` | Include document IDs in the summary (default: false) |
+
+## Generated Files
+
+- **README.md** — Overview of all registered models with fields, sections, and relationships
+- **TABLE-OF-CONTENTS.md** — Listing of all documents organized by model
+
+## Examples
+
+\`\`\`bash
+# Generate summary files
+cnotes summary
+
+# Generate for a specific content folder
+cnotes summary --contentFolder ./docs
+\`\`\`
+`,
+    argsSchema,
+    handler,
+});
+//# sourceMappingURL=summary.js.map

package/dist/cli/commands/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../../src/cli/commands/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAClD,CAAC,CAAA;AAEF,KAAK,UAAU,OAAO,CAAC,OAAmC;IACxD,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAA;IAEF,MAAM,UAAU,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACrE,OAAO,CAAC,GAAG,CAAC,wBAAwB,UAAU,CAAC,QAAQ,YAAY,CAAC,CAAA;IAEpE,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAA;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAA;IACjE,MAAM,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;IACtC,OAAO,CAAC,GAAG,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAA;AAC3D,CAAC;AAED,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE;IAC3B,WAAW,EAAE,gEAAgE;IAC7E,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BP;IACC,UAAU;IACV,OAAO;CACR,CAAC,CAAA"}

package/dist/cli/commands/teach.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=teach.d.ts.map

package/dist/cli/commands/teach.d.ts.map

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