contentbase 0.2.0 → 0.4.1
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.
- package/CNAME +1 -0
- package/LAUNCH-PLAN.md +419 -0
- package/dist/adapters/node-fs.d.ts +17 -0
- package/dist/adapters/node-fs.d.ts.map +1 -0
- package/dist/adapters/node-fs.js +71 -0
- package/dist/adapters/node-fs.js.map +1 -0
- package/dist/ast-query.d.ts +44 -0
- package/dist/ast-query.d.ts.map +1 -0
- package/dist/ast-query.js +95 -0
- package/dist/ast-query.js.map +1 -0
- package/dist/base-model.d.ts +8 -0
- package/dist/base-model.d.ts.map +1 -0
- package/dist/base-model.js +12 -0
- package/dist/base-model.js.map +1 -0
- package/dist/cli/commands/action.d.ts +2 -0
- package/dist/cli/commands/action.d.ts.map +1 -0
- package/dist/cli/commands/action.js +73 -0
- package/dist/cli/commands/action.js.map +1 -0
- package/dist/cli/commands/api/endpoints/actions.d.ts +13 -0
- package/dist/cli/commands/api/endpoints/actions.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/actions.js +28 -0
- package/dist/cli/commands/api/endpoints/actions.js.map +1 -0
- package/dist/cli/commands/api/endpoints/doc.d.ts +5 -0
- package/dist/cli/commands/api/endpoints/doc.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/doc.js +186 -0
- package/dist/cli/commands/api/endpoints/doc.js.map +1 -0
- package/dist/cli/commands/api/endpoints/docs-index.d.ts +8 -0
- package/dist/cli/commands/api/endpoints/docs-index.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/docs-index.js +23 -0
- package/dist/cli/commands/api/endpoints/docs-index.js.map +1 -0
- package/dist/cli/commands/api/endpoints/document.d.ts +47 -0
- package/dist/cli/commands/api/endpoints/document.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/document.js +146 -0
- package/dist/cli/commands/api/endpoints/document.js.map +1 -0
- package/dist/cli/commands/api/endpoints/documents.d.ts +35 -0
- package/dist/cli/commands/api/endpoints/documents.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/documents.js +56 -0
- package/dist/cli/commands/api/endpoints/documents.js.map +1 -0
- package/dist/cli/commands/api/endpoints/index.d.ts +22 -0
- package/dist/cli/commands/api/endpoints/index.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/index.js +38 -0
- package/dist/cli/commands/api/endpoints/index.js.map +1 -0
- package/dist/cli/commands/api/endpoints/inspect.d.ts +10 -0
- package/dist/cli/commands/api/endpoints/inspect.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/inspect.js +15 -0
- package/dist/cli/commands/api/endpoints/inspect.js.map +1 -0
- package/dist/cli/commands/api/endpoints/models.d.ts +5 -0
- package/dist/cli/commands/api/endpoints/models.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/models.js +9 -0
- package/dist/cli/commands/api/endpoints/models.js.map +1 -0
- package/dist/cli/commands/api/endpoints/query.d.ts +40 -0
- package/dist/cli/commands/api/endpoints/query.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/query.js +106 -0
- package/dist/cli/commands/api/endpoints/query.js.map +1 -0
- package/dist/cli/commands/api/endpoints/root.d.ts +5 -0
- package/dist/cli/commands/api/endpoints/root.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/root.js +7 -0
- package/dist/cli/commands/api/endpoints/root.js.map +1 -0
- package/dist/cli/commands/api/endpoints/search-reindex.d.ts +10 -0
- package/dist/cli/commands/api/endpoints/search-reindex.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/search-reindex.js +38 -0
- package/dist/cli/commands/api/endpoints/search-reindex.js.map +1 -0
- package/dist/cli/commands/api/endpoints/search-status.d.ts +7 -0
- package/dist/cli/commands/api/endpoints/search-status.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/search-status.js +33 -0
- package/dist/cli/commands/api/endpoints/search-status.js.map +1 -0
- package/dist/cli/commands/api/endpoints/search.d.ts +24 -0
- package/dist/cli/commands/api/endpoints/search.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/search.js +61 -0
- package/dist/cli/commands/api/endpoints/search.js.map +1 -0
- package/dist/cli/commands/api/endpoints/semantic-search.d.ts +28 -0
- package/dist/cli/commands/api/endpoints/semantic-search.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/semantic-search.js +76 -0
- package/dist/cli/commands/api/endpoints/semantic-search.js.map +1 -0
- package/dist/cli/commands/api/endpoints/text-search.d.ts +17 -0
- package/dist/cli/commands/api/endpoints/text-search.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/text-search.js +55 -0
- package/dist/cli/commands/api/endpoints/text-search.js.map +1 -0
- package/dist/cli/commands/api/endpoints/validate.d.ts +12 -0
- package/dist/cli/commands/api/endpoints/validate.d.ts.map +1 -0
- package/dist/cli/commands/api/endpoints/validate.js +27 -0
- package/dist/cli/commands/api/endpoints/validate.js.map +1 -0
- package/dist/cli/commands/api/helpers.d.ts +8 -0
- package/dist/cli/commands/api/helpers.d.ts.map +1 -0
- package/dist/cli/commands/api/helpers.js +89 -0
- package/dist/cli/commands/api/helpers.js.map +1 -0
- package/dist/cli/commands/console.d.ts +2 -0
- package/dist/cli/commands/console.d.ts.map +1 -0
- package/dist/cli/commands/console.js +117 -0
- package/dist/cli/commands/console.js.map +1 -0
- package/dist/cli/commands/create.d.ts +2 -0
- package/dist/cli/commands/create.d.ts.map +1 -0
- package/dist/cli/commands/create.js +185 -0
- package/dist/cli/commands/create.js.map +1 -0
- package/dist/cli/commands/embed.d.ts +2 -0
- package/dist/cli/commands/embed.d.ts.map +1 -0
- package/dist/cli/commands/embed.js +231 -0
- package/dist/cli/commands/embed.js.map +1 -0
- package/dist/cli/commands/export.d.ts +2 -0
- package/dist/cli/commands/export.d.ts.map +1 -0
- package/dist/cli/commands/export.js +55 -0
- package/dist/cli/commands/export.js.map +1 -0
- package/dist/cli/commands/extract.d.ts +2 -0
- package/dist/cli/commands/extract.d.ts.map +1 -0
- package/dist/cli/commands/extract.js +149 -0
- package/dist/cli/commands/extract.js.map +1 -0
- package/dist/cli/commands/help.d.ts +2 -0
- package/dist/cli/commands/help.d.ts.map +1 -0
- package/dist/cli/commands/help.js +58 -0
- package/dist/cli/commands/help.js.map +1 -0
- package/dist/cli/commands/index.d.ts +18 -0
- package/dist/cli/commands/index.d.ts.map +1 -0
- package/dist/cli/commands/index.js +19 -0
- package/dist/cli/commands/index.js.map +1 -0
- package/dist/cli/commands/init.d.ts +2 -0
- package/dist/cli/commands/init.d.ts.map +1 -0
- package/dist/cli/commands/init.js +82 -0
- package/dist/cli/commands/init.js.map +1 -0
- package/dist/cli/commands/inspect.d.ts +2 -0
- package/dist/cli/commands/inspect.d.ts.map +1 -0
- package/dist/cli/commands/inspect.js +53 -0
- package/dist/cli/commands/inspect.js.map +1 -0
- package/dist/cli/commands/mcp.d.ts +2 -0
- package/dist/cli/commands/mcp.d.ts.map +1 -0
- package/dist/cli/commands/mcp.js +92 -0
- package/dist/cli/commands/mcp.js.map +1 -0
- package/dist/cli/commands/search.d.ts +2 -0
- package/dist/cli/commands/search.d.ts.map +1 -0
- package/dist/cli/commands/search.js +212 -0
- package/dist/cli/commands/search.js.map +1 -0
- package/dist/cli/commands/serve.d.ts +2 -0
- package/dist/cli/commands/serve.d.ts.map +1 -0
- package/dist/cli/commands/serve.js +298 -0
- package/dist/cli/commands/serve.js.map +1 -0
- package/dist/cli/commands/summary.d.ts +2 -0
- package/dist/cli/commands/summary.d.ts.map +1 -0
- package/dist/cli/commands/summary.js +58 -0
- package/dist/cli/commands/summary.js.map +1 -0
- package/dist/cli/commands/teach.d.ts +2 -0
- package/dist/cli/commands/teach.d.ts.map +1 -0
- package/dist/cli/commands/teach.js +80 -0
- package/dist/cli/commands/teach.js.map +1 -0
- package/dist/cli/commands/text-search.d.ts +2 -0
- package/dist/cli/commands/text-search.d.ts.map +1 -0
- package/dist/cli/commands/text-search.js +125 -0
- package/dist/cli/commands/text-search.js.map +1 -0
- package/dist/cli/commands/update.d.ts +2 -0
- package/dist/cli/commands/update.d.ts.map +1 -0
- package/dist/cli/commands/update.js +167 -0
- package/dist/cli/commands/update.js.map +1 -0
- package/dist/cli/commands/validate.d.ts +2 -0
- package/dist/cli/commands/validate.d.ts.map +1 -0
- package/dist/cli/commands/validate.js +129 -0
- package/dist/cli/commands/validate.js.map +1 -0
- package/dist/cli/index.d.ts +3 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +84 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/load-collection.d.ts +7 -0
- package/dist/cli/load-collection.d.ts.map +1 -0
- package/dist/cli/load-collection.js +201 -0
- package/dist/cli/load-collection.js.map +1 -0
- package/dist/cli/registry.d.ts +17 -0
- package/dist/cli/registry.d.ts.map +1 -0
- package/dist/cli/registry.js +16 -0
- package/dist/cli/registry.js.map +1 -0
- package/dist/cnotes +0 -0
- package/dist/collection.d.ts +145 -0
- package/dist/collection.d.ts.map +1 -0
- package/dist/collection.js +684 -0
- package/dist/collection.js.map +1 -0
- package/dist/define-model.d.ts +45 -0
- package/dist/define-model.d.ts.map +1 -0
- package/dist/define-model.js +106 -0
- package/dist/define-model.js.map +1 -0
- package/dist/document.d.ts +119 -0
- package/dist/document.d.ts.map +1 -0
- package/dist/document.js +418 -0
- package/dist/document.js.map +1 -0
- package/dist/extract-sections.d.ts +46 -0
- package/dist/extract-sections.d.ts.map +1 -0
- package/dist/extract-sections.js +153 -0
- package/dist/extract-sections.js.map +1 -0
- package/dist/index.d.ts +28 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +31 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/helpers.d.ts +14 -0
- package/dist/mcp/helpers.d.ts.map +1 -0
- package/dist/mcp/helpers.js +7 -0
- package/dist/mcp/helpers.js.map +1 -0
- package/dist/mcp/model-info.d.ts +2 -0
- package/dist/mcp/model-info.d.ts.map +1 -0
- package/dist/mcp/model-info.js +94 -0
- package/dist/mcp/model-info.js.map +1 -0
- package/dist/mcp/prompts.d.ts +2 -0
- package/dist/mcp/prompts.d.ts.map +1 -0
- package/dist/mcp/prompts.js +180 -0
- package/dist/mcp/prompts.js.map +1 -0
- package/dist/mcp/readme.d.ts +2 -0
- package/dist/mcp/readme.d.ts.map +1 -0
- package/dist/mcp/readme.js +71 -0
- package/dist/mcp/readme.js.map +1 -0
- package/dist/mcp/resources.d.ts +2 -0
- package/dist/mcp/resources.d.ts.map +1 -0
- package/dist/mcp/resources.js +85 -0
- package/dist/mcp/resources.js.map +1 -0
- package/dist/mcp/server.d.ts +18 -0
- package/dist/mcp/server.d.ts.map +1 -0
- package/dist/mcp/server.js +83 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/mcp/tools/mutation.d.ts +2 -0
- package/dist/mcp/tools/mutation.d.ts.map +1 -0
- package/dist/mcp/tools/mutation.js +155 -0
- package/dist/mcp/tools/mutation.js.map +1 -0
- package/dist/mcp/tools/query.d.ts +2 -0
- package/dist/mcp/tools/query.d.ts.map +1 -0
- package/dist/mcp/tools/query.js +130 -0
- package/dist/mcp/tools/query.js.map +1 -0
- package/dist/mcp/tools/search.d.ts +2 -0
- package/dist/mcp/tools/search.d.ts.map +1 -0
- package/dist/mcp/tools/search.js +168 -0
- package/dist/mcp/tools/search.js.map +1 -0
- package/dist/model-instance.d.ts +11 -0
- package/dist/model-instance.d.ts.map +1 -0
- package/dist/model-instance.js +208 -0
- package/dist/model-instance.js.map +1 -0
- package/dist/node-shortcuts.d.ts +25 -0
- package/dist/node-shortcuts.d.ts.map +1 -0
- package/dist/node-shortcuts.js +67 -0
- package/dist/node-shortcuts.js.map +1 -0
- package/dist/parse.d.ts +45 -0
- package/dist/parse.d.ts.map +1 -0
- package/dist/parse.js +98 -0
- package/dist/parse.js.map +1 -0
- package/dist/query/collection-query.d.ts +39 -0
- package/dist/query/collection-query.d.ts.map +1 -0
- package/dist/query/collection-query.js +184 -0
- package/dist/query/collection-query.js.map +1 -0
- package/dist/query/index.d.ts +8 -0
- package/dist/query/index.d.ts.map +1 -0
- package/dist/query/index.js +5 -0
- package/dist/query/index.js.map +1 -0
- package/dist/query/operators.d.ts +3 -0
- package/dist/query/operators.d.ts.map +1 -0
- package/dist/query/operators.js +18 -0
- package/dist/query/operators.js.map +1 -0
- package/dist/query/query-builder.d.ts +34 -0
- package/dist/query/query-builder.d.ts.map +1 -0
- package/dist/query/query-builder.js +84 -0
- package/dist/query/query-builder.js.map +1 -0
- package/dist/query/query-dsl.d.ts +36 -0
- package/dist/query/query-dsl.d.ts.map +1 -0
- package/dist/query/query-dsl.js +195 -0
- package/dist/query/query-dsl.js.map +1 -0
- package/dist/relationships/belongs-to.d.ts +9 -0
- package/dist/relationships/belongs-to.d.ts.map +1 -0
- package/dist/relationships/belongs-to.js +34 -0
- package/dist/relationships/belongs-to.js.map +1 -0
- package/dist/relationships/has-many.d.ts +23 -0
- package/dist/relationships/has-many.d.ts.map +1 -0
- package/dist/relationships/has-many.js +136 -0
- package/dist/relationships/has-many.js.map +1 -0
- package/dist/relationships/index.d.ts +26 -0
- package/dist/relationships/index.d.ts.map +1 -0
- package/dist/relationships/index.js +32 -0
- package/dist/relationships/index.js.map +1 -0
- package/dist/relationships/types.d.ts +2 -0
- package/dist/relationships/types.d.ts.map +1 -0
- package/dist/relationships/types.js +2 -0
- package/dist/relationships/types.js.map +1 -0
- package/dist/search/document-inputs.d.ts +30 -0
- package/dist/search/document-inputs.d.ts.map +1 -0
- package/dist/search/document-inputs.js +52 -0
- package/dist/search/document-inputs.js.map +1 -0
- package/dist/search/luca-semantic-search.d.ts +27 -0
- package/dist/search/luca-semantic-search.d.ts.map +1 -0
- package/dist/search/luca-semantic-search.js +56 -0
- package/dist/search/luca-semantic-search.js.map +1 -0
- package/dist/section.d.ts +21 -0
- package/dist/section.d.ts.map +1 -0
- package/dist/section.js +21 -0
- package/dist/section.js.map +1 -0
- package/dist/types.d.ts +185 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/dist/utils/index.d.ts +9 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +8 -0
- package/dist/utils/index.js.map +1 -0
- package/dist/utils/inflect.d.ts +6 -0
- package/dist/utils/inflect.d.ts.map +1 -0
- package/dist/utils/inflect.js +75 -0
- package/dist/utils/inflect.js.map +1 -0
- package/dist/utils/match-pattern.d.ts +25 -0
- package/dist/utils/match-pattern.d.ts.map +1 -0
- package/dist/utils/match-pattern.js +52 -0
- package/dist/utils/match-pattern.js.map +1 -0
- package/dist/utils/normalize-headings.d.ts +8 -0
- package/dist/utils/normalize-headings.d.ts.map +1 -0
- package/dist/utils/normalize-headings.js +19 -0
- package/dist/utils/normalize-headings.js.map +1 -0
- package/dist/utils/parse-table.d.ts +7 -0
- package/dist/utils/parse-table.d.ts.map +1 -0
- package/dist/utils/parse-table.js +17 -0
- package/dist/utils/parse-table.js.map +1 -0
- package/dist/utils/read-directory.d.ts +5 -0
- package/dist/utils/read-directory.d.ts.map +1 -0
- package/dist/utils/read-directory.js +29 -0
- package/dist/utils/read-directory.js.map +1 -0
- package/dist/utils/stringify-ast.d.ts +6 -0
- package/dist/utils/stringify-ast.d.ts.map +1 -0
- package/dist/utils/stringify-ast.js +8 -0
- package/dist/utils/stringify-ast.js.map +1 -0
- package/dist/utils/strip-markdown.d.ts +11 -0
- package/dist/utils/strip-markdown.d.ts.map +1 -0
- package/dist/utils/strip-markdown.js +48 -0
- package/dist/utils/strip-markdown.js.map +1 -0
- package/dist/validator.d.ts +10 -0
- package/dist/validator.d.ts.map +1 -0
- package/dist/validator.js +55 -0
- package/dist/validator.js.map +1 -0
- package/index.html +1636 -0
- package/package.json +5 -4
- package/src/adapters/node-fs.ts +80 -0
- package/src/cli/commands/api/endpoints/doc.ts +2 -2
- package/src/cli/commands/api/endpoints/document.ts +2 -2
- package/src/cli/commands/api/endpoints/search-reindex.ts +6 -25
- package/src/cli/commands/api/endpoints/search-status.ts +3 -20
- package/src/cli/commands/api/endpoints/search.ts +3 -33
- package/src/cli/commands/api/endpoints/semantic-search.ts +3 -33
- package/src/cli/commands/embed.ts +8 -81
- package/src/cli/commands/mcp.ts +5 -1128
- package/src/cli/commands/search.ts +4 -76
- package/src/cli/commands/serve.ts +7 -32
- package/src/cli/index.ts +1 -1
- package/src/cli/load-collection.ts +2 -2
- package/src/collection.ts +31 -30
- package/src/document.ts +18 -0
- package/src/extract-sections.ts +3 -0
- package/src/index.ts +10 -0
- package/src/mcp/helpers.ts +7 -0
- package/src/mcp/model-info.ts +102 -0
- package/src/mcp/prompts.ts +199 -0
- package/src/mcp/readme.ts +153 -0
- package/src/mcp/resources.ts +89 -0
- package/src/mcp/server.ts +103 -0
- package/src/mcp/tools/mutation.ts +176 -0
- package/src/mcp/tools/query.ts +141 -0
- package/src/mcp/tools/search.ts +180 -0
- package/src/parse.ts +5 -0
- package/src/query/query-dsl.ts +1 -1
- package/src/relationships/has-many.ts +2 -2
- package/src/search/document-inputs.ts +85 -0
- package/src/search/luca-semantic-search.ts +75 -0
- package/src/types.ts +54 -0
- package/src/utils/index.ts +2 -0
- package/src/utils/match-pattern.ts +2 -2
- package/src/utils/strip-markdown.ts +59 -0
|
@@ -0,0 +1,298 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import fs from 'node:fs';
|
|
4
|
+
import { commands } from '../registry.js';
|
|
5
|
+
import { loadCollection } from '../load-collection.js';
|
|
6
|
+
import { buildSchemaJSON } from './api/helpers.js';
|
|
7
|
+
import { builtinEndpoints } from './api/endpoints/index.js';
|
|
8
|
+
import { collectDocumentInputs } from '../../search/document-inputs.js';
|
|
9
|
+
import { getInitializedSemanticSearch, hasSearchIndex } from '../../search/luca-semantic-search.js';
|
|
10
|
+
const argsSchema = z.object({
|
|
11
|
+
port: z.number().default(8000),
|
|
12
|
+
contentFolder: z.string().optional(),
|
|
13
|
+
modulePath: z.string().optional(),
|
|
14
|
+
endpointsDir: z.string().optional(),
|
|
15
|
+
staticDir: z.string().optional(),
|
|
16
|
+
cors: z.boolean().default(true),
|
|
17
|
+
force: z.boolean().default(false),
|
|
18
|
+
anyPort: z.boolean().default(false),
|
|
19
|
+
open: z.boolean().default(false),
|
|
20
|
+
readOnly: z.boolean().default(false),
|
|
21
|
+
refreshInterval: z.number().optional(),
|
|
22
|
+
watch: z.boolean().default(true),
|
|
23
|
+
search: z.boolean().default(false),
|
|
24
|
+
});
|
|
25
|
+
async function handler(options, context) {
|
|
26
|
+
const container = context.container;
|
|
27
|
+
const { networking, proc } = container;
|
|
28
|
+
// Resolve content folder from positional arg or option
|
|
29
|
+
const positionalFolder = container.argv._[1];
|
|
30
|
+
const contentFolder = positionalFolder || options.contentFolder || undefined;
|
|
31
|
+
const modulePath = options.modulePath || undefined;
|
|
32
|
+
const collection = await loadCollection({ contentFolder, modulePath });
|
|
33
|
+
const modelDefs = collection.modelDefinitions;
|
|
34
|
+
// Attach collection to container so endpoints can access it
|
|
35
|
+
container._contentbaseCollection = collection;
|
|
36
|
+
container._contentbaseReadOnly = options.readOnly;
|
|
37
|
+
// ---------------------------------------------------------------------------
|
|
38
|
+
// Port handling
|
|
39
|
+
// ---------------------------------------------------------------------------
|
|
40
|
+
let port = options.port;
|
|
41
|
+
if (options.anyPort) {
|
|
42
|
+
port = await networking.findOpenPort(port + 1);
|
|
43
|
+
}
|
|
44
|
+
const isPortAvailable = await networking.isPortOpen(port);
|
|
45
|
+
if (!isPortAvailable) {
|
|
46
|
+
if (!options.force) {
|
|
47
|
+
console.error(`Port ${port} is already in use.`);
|
|
48
|
+
console.error(`Use --force to kill the process on this port, or --any-port to find another port.`);
|
|
49
|
+
process.exit(1);
|
|
50
|
+
}
|
|
51
|
+
const pids = proc.findPidsByPort(port);
|
|
52
|
+
if (!pids.length) {
|
|
53
|
+
console.error(`Port ${port} is in use, but no PID could be discovered for termination.`);
|
|
54
|
+
process.exit(1);
|
|
55
|
+
}
|
|
56
|
+
for (const pid of pids) {
|
|
57
|
+
proc.kill(pid);
|
|
58
|
+
}
|
|
59
|
+
let portFreed = false;
|
|
60
|
+
for (let i = 0; i < 10; i++) {
|
|
61
|
+
if (await networking.isPortOpen(port)) {
|
|
62
|
+
portFreed = true;
|
|
63
|
+
break;
|
|
64
|
+
}
|
|
65
|
+
await new Promise((resolve) => setTimeout(resolve, 100));
|
|
66
|
+
}
|
|
67
|
+
if (!portFreed) {
|
|
68
|
+
console.error(`Failed to free port ${port} after terminating process(es): ${pids.join(', ')}`);
|
|
69
|
+
process.exit(1);
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
// ---------------------------------------------------------------------------
|
|
73
|
+
// Static directory
|
|
74
|
+
// ---------------------------------------------------------------------------
|
|
75
|
+
const cwd = process.cwd();
|
|
76
|
+
const staticDir = options.staticDir ? path.resolve(cwd, options.staticDir) : path.resolve(cwd, 'public');
|
|
77
|
+
let resolvedStaticDir;
|
|
78
|
+
if (fs.existsSync(staticDir)) {
|
|
79
|
+
resolvedStaticDir = staticDir;
|
|
80
|
+
}
|
|
81
|
+
else if (fs.existsSync(path.resolve(cwd, 'index.html'))) {
|
|
82
|
+
resolvedStaticDir = cwd;
|
|
83
|
+
}
|
|
84
|
+
// ---------------------------------------------------------------------------
|
|
85
|
+
// User endpoints directory
|
|
86
|
+
// ---------------------------------------------------------------------------
|
|
87
|
+
let userEndpointsDir = null;
|
|
88
|
+
if (options.endpointsDir) {
|
|
89
|
+
const dir = path.resolve(cwd, options.endpointsDir);
|
|
90
|
+
if (fs.existsSync(dir))
|
|
91
|
+
userEndpointsDir = dir;
|
|
92
|
+
}
|
|
93
|
+
else {
|
|
94
|
+
for (const candidate of ['endpoints', 'src/endpoints']) {
|
|
95
|
+
const dir = path.resolve(cwd, candidate);
|
|
96
|
+
if (fs.existsSync(dir)) {
|
|
97
|
+
userEndpointsDir = dir;
|
|
98
|
+
break;
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
// ---------------------------------------------------------------------------
|
|
103
|
+
// Express server
|
|
104
|
+
// ---------------------------------------------------------------------------
|
|
105
|
+
const expressServer = container.server('express', {
|
|
106
|
+
port,
|
|
107
|
+
cors: options.cors,
|
|
108
|
+
static: resolvedStaticDir,
|
|
109
|
+
historyFallback: false,
|
|
110
|
+
});
|
|
111
|
+
// Load built-in contentbase endpoints (statically imported so they survive bun compile)
|
|
112
|
+
await expressServer.useEndpointModules(builtinEndpoints);
|
|
113
|
+
// Load user endpoints if present
|
|
114
|
+
if (userEndpointsDir) {
|
|
115
|
+
await expressServer.useEndpoints(userEndpointsDir);
|
|
116
|
+
}
|
|
117
|
+
// Redirect root to /docs/ table of contents when no static index.html exists
|
|
118
|
+
if (!resolvedStaticDir || !fs.existsSync(path.join(resolvedStaticDir, 'index.html'))) {
|
|
119
|
+
expressServer.app.get('/', (_req, res) => {
|
|
120
|
+
res.redirect('/docs/');
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
// OpenAPI spec
|
|
124
|
+
expressServer.serveOpenAPISpec({
|
|
125
|
+
title: 'Contentbase API',
|
|
126
|
+
version: '1.0.0',
|
|
127
|
+
description: `REST API for ${collection.rootPath}`,
|
|
128
|
+
});
|
|
129
|
+
await expressServer.start({ port });
|
|
130
|
+
// ---------------------------------------------------------------------------
|
|
131
|
+
// Startup summary
|
|
132
|
+
// ---------------------------------------------------------------------------
|
|
133
|
+
const schema = buildSchemaJSON(collection);
|
|
134
|
+
const modelNames = Object.keys(schema);
|
|
135
|
+
console.log(`\nContentbase server listening on http://localhost:${port}`);
|
|
136
|
+
console.log(`Collection: ${collection.rootPath}`);
|
|
137
|
+
console.log(`Models: ${modelNames.join(', ') || '(none)'}`);
|
|
138
|
+
console.log(`Documents: ${collection.available.length}`);
|
|
139
|
+
if (options.readOnly) {
|
|
140
|
+
console.log(`Mode: read-only (write endpoints disabled)`);
|
|
141
|
+
}
|
|
142
|
+
console.log(`OpenAPI spec: http://localhost:${port}/openapi.json`);
|
|
143
|
+
if (resolvedStaticDir) {
|
|
144
|
+
console.log(`Static files: ${resolvedStaticDir}`);
|
|
145
|
+
}
|
|
146
|
+
if (expressServer._mountedEndpoints?.length) {
|
|
147
|
+
console.log(`\nEndpoints:`);
|
|
148
|
+
for (const ep of expressServer._mountedEndpoints) {
|
|
149
|
+
console.log(` ${ep.methods.map((m) => m.toUpperCase()).join(', ').padEnd(20)} ${ep.path}`);
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
console.log();
|
|
153
|
+
if (options.open) {
|
|
154
|
+
try {
|
|
155
|
+
const opener = container.feature('opener');
|
|
156
|
+
await opener.open(`http://localhost:${port}`);
|
|
157
|
+
}
|
|
158
|
+
catch (error) {
|
|
159
|
+
console.warn(`Could not open browser automatically: ${error.message}`);
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
// ---------------------------------------------------------------------------
|
|
163
|
+
// Search index auto-update
|
|
164
|
+
// ---------------------------------------------------------------------------
|
|
165
|
+
if (options.search) {
|
|
166
|
+
if (hasSearchIndex(collection.rootPath)) {
|
|
167
|
+
try {
|
|
168
|
+
const ss = await getInitializedSemanticSearch(container, collection.rootPath);
|
|
169
|
+
const docs = collectDocumentInputs(collection);
|
|
170
|
+
const stale = docs.filter((d) => ss.needsReindex(d));
|
|
171
|
+
ss.removeStale(docs.map((d) => d.pathId));
|
|
172
|
+
if (stale.length > 0) {
|
|
173
|
+
console.log(`[search] Updating ${stale.length} stale document(s)...`);
|
|
174
|
+
await ss.indexDocuments(stale);
|
|
175
|
+
console.log(`[search] Index updated.`);
|
|
176
|
+
}
|
|
177
|
+
else {
|
|
178
|
+
console.log(`[search] Index is up to date.`);
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
catch (error) {
|
|
182
|
+
console.warn(`[search] Auto-index failed: ${error.message}`);
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
else {
|
|
186
|
+
console.log(`[search] No search index found. Run: cnotes embed`);
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
// ---------------------------------------------------------------------------
|
|
190
|
+
// File watching
|
|
191
|
+
// ---------------------------------------------------------------------------
|
|
192
|
+
if (options.watch !== false) {
|
|
193
|
+
const fileManager = container.feature('fileManager');
|
|
194
|
+
await fileManager.start({ rootPath: collection.rootPath });
|
|
195
|
+
await fileManager.watch();
|
|
196
|
+
const { debounce } = container.utils.lodash;
|
|
197
|
+
const refreshCollection = debounce(async () => {
|
|
198
|
+
try {
|
|
199
|
+
const before = collection.available.length;
|
|
200
|
+
await collection.load({ refresh: true });
|
|
201
|
+
const after = collection.available.length;
|
|
202
|
+
if (after !== before) {
|
|
203
|
+
console.log(`[watch] Collection refreshed: ${before} → ${after} documents`);
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
catch (error) {
|
|
207
|
+
console.warn(`[watch] Refresh failed: ${error.message}`);
|
|
208
|
+
}
|
|
209
|
+
}, 500);
|
|
210
|
+
fileManager.on('file:change', (event) => {
|
|
211
|
+
if (/\.(md|mdx)$/i.test(event.path)) {
|
|
212
|
+
refreshCollection();
|
|
213
|
+
}
|
|
214
|
+
});
|
|
215
|
+
console.log(`Watching for file changes in ${collection.rootPath}`);
|
|
216
|
+
}
|
|
217
|
+
// ---------------------------------------------------------------------------
|
|
218
|
+
// Collection refresh interval (safety-net fallback)
|
|
219
|
+
// ---------------------------------------------------------------------------
|
|
220
|
+
const defaultInterval = container.isProduction ? 10 * 60 : 60; // seconds
|
|
221
|
+
const intervalSeconds = options.refreshInterval ?? defaultInterval;
|
|
222
|
+
setInterval(async () => {
|
|
223
|
+
try {
|
|
224
|
+
const before = collection.available.length;
|
|
225
|
+
await collection.load({ refresh: true });
|
|
226
|
+
const after = collection.available.length;
|
|
227
|
+
if (after !== before) {
|
|
228
|
+
console.log(`[refresh] Collection rescanned: ${before} → ${after} documents`);
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
catch (error) {
|
|
232
|
+
console.warn(`[refresh] Failed to rescan collection: ${error.message}`);
|
|
233
|
+
}
|
|
234
|
+
}, intervalSeconds * 1000);
|
|
235
|
+
console.log(`Refresh interval: every ${intervalSeconds}s`);
|
|
236
|
+
}
|
|
237
|
+
commands.register('serve', {
|
|
238
|
+
description: 'Start an HTTP server for the collection with REST API and document serving',
|
|
239
|
+
help: `# cnotes serve
|
|
240
|
+
|
|
241
|
+
Start an HTTP server with REST API endpoints for querying, creating, updating, and deleting documents. Serves static files and auto-generates an OpenAPI spec.
|
|
242
|
+
|
|
243
|
+
## Usage
|
|
244
|
+
|
|
245
|
+
\`\`\`
|
|
246
|
+
cnotes serve [contentFolder] [options]
|
|
247
|
+
\`\`\`
|
|
248
|
+
|
|
249
|
+
## Arguments
|
|
250
|
+
|
|
251
|
+
| Argument | Description |
|
|
252
|
+
|----------|-------------|
|
|
253
|
+
| \`contentFolder\` | Path to content folder (positional or via \`--contentFolder\`) |
|
|
254
|
+
|
|
255
|
+
## Options
|
|
256
|
+
|
|
257
|
+
| Option | Default | Description |
|
|
258
|
+
|--------|---------|-------------|
|
|
259
|
+
| \`--port\` | \`8000\` | Port to listen on |
|
|
260
|
+
| \`--force\` | \`false\` | Kill existing process on the port |
|
|
261
|
+
| \`--anyPort\` | \`false\` | Find next available port if taken |
|
|
262
|
+
| \`--open\` | \`false\` | Open browser after starting |
|
|
263
|
+
| \`--readOnly\` | \`false\` | Disable write endpoints |
|
|
264
|
+
| \`--cors\` | \`true\` | Enable CORS |
|
|
265
|
+
| \`--staticDir\` | \`public/\` | Directory for static file serving |
|
|
266
|
+
| \`--endpointsDir\` | auto | Directory for user endpoint modules |
|
|
267
|
+
| \`--modulePath\` | | Path to collection entry module |
|
|
268
|
+
| \`--refreshInterval\` | \`60\` | Seconds between collection rescans (fallback) |
|
|
269
|
+
| \`--disable-watch\` | \`false\` | Disable file watching for automatic collection refresh |
|
|
270
|
+
| \`--contentFolder\` | | Path to content folder |
|
|
271
|
+
|
|
272
|
+
## User Endpoints
|
|
273
|
+
|
|
274
|
+
Place endpoint modules in \`endpoints/\` or \`src/endpoints/\` and they'll be auto-mounted. Use \`--endpointsDir\` to override.
|
|
275
|
+
|
|
276
|
+
## Examples
|
|
277
|
+
|
|
278
|
+
\`\`\`bash
|
|
279
|
+
# Start on default port
|
|
280
|
+
cnotes serve
|
|
281
|
+
|
|
282
|
+
# Serve a specific folder on a custom port
|
|
283
|
+
cnotes serve ./docs --port 3000
|
|
284
|
+
|
|
285
|
+
# Force kill existing server and open browser
|
|
286
|
+
cnotes serve --port 8000 --force --open
|
|
287
|
+
|
|
288
|
+
# Read-only mode for production
|
|
289
|
+
cnotes serve --readOnly --port 8080
|
|
290
|
+
|
|
291
|
+
# Find any available port
|
|
292
|
+
cnotes serve --anyPort
|
|
293
|
+
\`\`\`
|
|
294
|
+
`,
|
|
295
|
+
argsSchema,
|
|
296
|
+
handler,
|
|
297
|
+
});
|
|
298
|
+
//# sourceMappingURL=serve.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/cli/commands/serve.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/summary.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { writeFile } from 'node:fs/promises';
|
|
3
|
+
import { join } from 'node:path';
|
|
4
|
+
import { commands } from '../registry.js';
|
|
5
|
+
import { loadCollection } from '../load-collection.js';
|
|
6
|
+
const argsSchema = z.object({
|
|
7
|
+
contentFolder: z.string().optional(),
|
|
8
|
+
includeIds: z.boolean().optional().default(false),
|
|
9
|
+
});
|
|
10
|
+
async function handler(options) {
|
|
11
|
+
const collection = await loadCollection({
|
|
12
|
+
contentFolder: options.contentFolder,
|
|
13
|
+
});
|
|
14
|
+
await collection.saveModelSummary({ includeIds: options.includeIds });
|
|
15
|
+
console.log(`README.md written to ${collection.rootPath}/README.md`);
|
|
16
|
+
const toc = collection.tableOfContents({ title: 'Table of Contents' });
|
|
17
|
+
const tocPath = join(collection.rootPath, 'TABLE-OF-CONTENTS.md');
|
|
18
|
+
await writeFile(tocPath, toc, 'utf-8');
|
|
19
|
+
console.log(`TABLE-OF-CONTENTS.md written to ${tocPath}`);
|
|
20
|
+
}
|
|
21
|
+
commands.register('summary', {
|
|
22
|
+
description: 'Generate README.md and TABLE-OF-CONTENTS.md for the collection',
|
|
23
|
+
help: `# cnotes summary
|
|
24
|
+
|
|
25
|
+
Generate documentation files for the collection. Writes \`README.md\` (model definitions summary) and \`TABLE-OF-CONTENTS.md\` (document listing) to the content root.
|
|
26
|
+
|
|
27
|
+
## Usage
|
|
28
|
+
|
|
29
|
+
\`\`\`
|
|
30
|
+
cnotes summary [options]
|
|
31
|
+
\`\`\`
|
|
32
|
+
|
|
33
|
+
## Options
|
|
34
|
+
|
|
35
|
+
| Option | Description |
|
|
36
|
+
|--------|-------------|
|
|
37
|
+
| \`--contentFolder\` | Path to content folder |
|
|
38
|
+
| \`--include-ids\` | Include document IDs in the summary (default: false) |
|
|
39
|
+
|
|
40
|
+
## Generated Files
|
|
41
|
+
|
|
42
|
+
- **README.md** — Overview of all registered models with fields, sections, and relationships
|
|
43
|
+
- **TABLE-OF-CONTENTS.md** — Listing of all documents organized by model
|
|
44
|
+
|
|
45
|
+
## Examples
|
|
46
|
+
|
|
47
|
+
\`\`\`bash
|
|
48
|
+
# Generate summary files
|
|
49
|
+
cnotes summary
|
|
50
|
+
|
|
51
|
+
# Generate for a specific content folder
|
|
52
|
+
cnotes summary --contentFolder ./docs
|
|
53
|
+
\`\`\`
|
|
54
|
+
`,
|
|
55
|
+
argsSchema,
|
|
56
|
+
handler,
|
|
57
|
+
});
|
|
58
|
+
//# sourceMappingURL=summary.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"teach.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/teach.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import fs from 'fs/promises';
|
|
3
|
+
import path from 'path';
|
|
4
|
+
import { commands } from '../registry.js';
|
|
5
|
+
import { loadCollection } from '../load-collection.js';
|
|
6
|
+
const argsSchema = z.object({
|
|
7
|
+
contentFolder: z.string().optional(),
|
|
8
|
+
});
|
|
9
|
+
async function handler(options) {
|
|
10
|
+
const collection = await loadCollection({
|
|
11
|
+
contentFolder: options.contentFolder,
|
|
12
|
+
});
|
|
13
|
+
const modelsSummary = collection.generateModelSummary();
|
|
14
|
+
const toc = collection.tableOfContents({ title: 'Table of Contents' });
|
|
15
|
+
// Read the bundled static docs from the contentbase package
|
|
16
|
+
const packageRoot = path.resolve(import.meta.dir, '../../..');
|
|
17
|
+
const primer = await fs.readFile(path.join(packageRoot, 'PRIMER.md'), 'utf8');
|
|
18
|
+
const cli = await fs.readFile(path.join(packageRoot, 'CLI.md'), 'utf8');
|
|
19
|
+
const output = [
|
|
20
|
+
modelsSummary.trimEnd(),
|
|
21
|
+
'',
|
|
22
|
+
'---',
|
|
23
|
+
'',
|
|
24
|
+
toc.trimEnd(),
|
|
25
|
+
'',
|
|
26
|
+
'---',
|
|
27
|
+
'',
|
|
28
|
+
cli.trimEnd(),
|
|
29
|
+
'',
|
|
30
|
+
'---',
|
|
31
|
+
'',
|
|
32
|
+
primer.trimEnd(),
|
|
33
|
+
'',
|
|
34
|
+
].join('\n');
|
|
35
|
+
console.log(output);
|
|
36
|
+
}
|
|
37
|
+
commands.register('teach', {
|
|
38
|
+
description: 'Output combined documentation (README.md + TOC + CLI.md + PRIMER.md) for LLM context',
|
|
39
|
+
help: `# cnotes teach
|
|
40
|
+
|
|
41
|
+
Output combined documentation suitable for feeding to an LLM as context. Concatenates the models summary, table of contents, CLI reference, and API primer into a single stream.
|
|
42
|
+
|
|
43
|
+
## Usage
|
|
44
|
+
|
|
45
|
+
\`\`\`
|
|
46
|
+
cnotes teach [options]
|
|
47
|
+
\`\`\`
|
|
48
|
+
|
|
49
|
+
## Options
|
|
50
|
+
|
|
51
|
+
| Option | Description |
|
|
52
|
+
|--------|-------------|
|
|
53
|
+
| \`--contentFolder\` | Path to content folder |
|
|
54
|
+
|
|
55
|
+
## Output
|
|
56
|
+
|
|
57
|
+
Writes to stdout in this order:
|
|
58
|
+
|
|
59
|
+
1. **README.md** — Model definitions summary
|
|
60
|
+
2. **TABLE-OF-CONTENTS.md** — Document listing
|
|
61
|
+
3. **CLI.md** — CLI reference
|
|
62
|
+
4. **PRIMER.md** — API primer
|
|
63
|
+
|
|
64
|
+
## Examples
|
|
65
|
+
|
|
66
|
+
\`\`\`bash
|
|
67
|
+
# Print full documentation
|
|
68
|
+
cnotes teach
|
|
69
|
+
|
|
70
|
+
# Save to a file for LLM context
|
|
71
|
+
cnotes teach > context.md
|
|
72
|
+
|
|
73
|
+
# Teach from a specific content folder
|
|
74
|
+
cnotes teach --contentFolder ./docs
|
|
75
|
+
\`\`\`
|
|
76
|
+
`,
|
|
77
|
+
argsSchema,
|
|
78
|
+
handler,
|
|
79
|
+
});
|
|
80
|
+
//# sourceMappingURL=teach.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"teach.js","sourceRoot":"","sources":["../../../src/cli/commands/teach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,MAAM,aAAa,CAAA;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,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;CACrC,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,aAAa,GAAG,UAAU,CAAC,oBAAoB,EAAE,CAAA;IACvD,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAA;IAEtE,4DAA4D;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAA;IAC7E,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAA;IAEvE,MAAM,MAAM,GAAG;QACb,aAAa,CAAC,OAAO,EAAE;QACvB,EAAE;QACF,KAAK;QACL,EAAE;QACF,GAAG,CAAC,OAAO,EAAE;QACb,EAAE;QACF,KAAK;QACL,EAAE;QACF,GAAG,CAAC,OAAO,EAAE;QACb,EAAE;QACF,KAAK;QACL,EAAE;QACF,MAAM,CAAC,OAAO,EAAE;QAChB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEZ,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AACrB,CAAC;AAED,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE;IACzB,WAAW,EAAE,sFAAsF;IACnG,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCP;IACC,UAAU;IACV,OAAO;CACR,CAAC,CAAA"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"text-search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/text-search.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { commands } from '../registry.js';
|
|
3
|
+
import { loadCollection } from '../load-collection.js';
|
|
4
|
+
const argsSchema = z.object({
|
|
5
|
+
include: z.string().optional(),
|
|
6
|
+
exclude: z.string().optional(),
|
|
7
|
+
ignoreCase: z.boolean().default(false),
|
|
8
|
+
expanded: z.boolean().default(false),
|
|
9
|
+
maxResults: z.number().optional(),
|
|
10
|
+
contentFolder: z.string().optional(),
|
|
11
|
+
});
|
|
12
|
+
async function handler(options, { container }) {
|
|
13
|
+
const pattern = container.argv._[1];
|
|
14
|
+
if (!pattern) {
|
|
15
|
+
console.error('Usage: cnotes text-search <pattern> [options]');
|
|
16
|
+
console.error(' --expanded Show line-level matches (default: files only)');
|
|
17
|
+
console.error(' --include Glob filter (e.g. "*.md")');
|
|
18
|
+
console.error(' --exclude Glob filter');
|
|
19
|
+
console.error(' --ignoreCase Case insensitive search');
|
|
20
|
+
console.error(' --maxResults Limit number of results');
|
|
21
|
+
process.exit(1);
|
|
22
|
+
}
|
|
23
|
+
const collection = await loadCollection({
|
|
24
|
+
contentFolder: options.contentFolder,
|
|
25
|
+
});
|
|
26
|
+
const grep = container.feature('grep');
|
|
27
|
+
const searchPath = collection.rootPath;
|
|
28
|
+
const grepOptions = {
|
|
29
|
+
pattern,
|
|
30
|
+
path: searchPath,
|
|
31
|
+
ignoreCase: options.ignoreCase,
|
|
32
|
+
maxResults: options.maxResults,
|
|
33
|
+
include: options.include,
|
|
34
|
+
exclude: options.exclude,
|
|
35
|
+
};
|
|
36
|
+
if (!options.expanded) {
|
|
37
|
+
const files = await grep.filesContaining(pattern, {
|
|
38
|
+
path: searchPath,
|
|
39
|
+
ignoreCase: options.ignoreCase,
|
|
40
|
+
maxResults: options.maxResults,
|
|
41
|
+
include: options.include,
|
|
42
|
+
exclude: options.exclude,
|
|
43
|
+
});
|
|
44
|
+
if (files.length === 0) {
|
|
45
|
+
console.log('No matches found.');
|
|
46
|
+
return;
|
|
47
|
+
}
|
|
48
|
+
console.log(`${files.length} file(s) match:\n`);
|
|
49
|
+
for (const file of files) {
|
|
50
|
+
console.log(` ${file}`);
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
else {
|
|
54
|
+
const results = await grep.search(grepOptions);
|
|
55
|
+
if (results.length === 0) {
|
|
56
|
+
console.log('No matches found.');
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
// Group by file
|
|
60
|
+
const grouped = new Map();
|
|
61
|
+
for (const match of results) {
|
|
62
|
+
if (!grouped.has(match.file))
|
|
63
|
+
grouped.set(match.file, []);
|
|
64
|
+
grouped.get(match.file).push(match);
|
|
65
|
+
}
|
|
66
|
+
console.log(`${grouped.size} file(s), ${results.length} match(es):\n`);
|
|
67
|
+
for (const [file, matches] of grouped) {
|
|
68
|
+
console.log(` ${file}`);
|
|
69
|
+
for (const m of matches) {
|
|
70
|
+
console.log(` ${m.line}: ${m.content}`);
|
|
71
|
+
}
|
|
72
|
+
console.log();
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
commands.register('text-search', {
|
|
77
|
+
description: 'Search file contents with pattern matching',
|
|
78
|
+
usage: '<pattern>',
|
|
79
|
+
help: `# cnotes text-search
|
|
80
|
+
|
|
81
|
+
Search file contents within the collection using ripgrep. Returns matching files by default, or line-level detail with \`--expanded\`.
|
|
82
|
+
|
|
83
|
+
## Usage
|
|
84
|
+
|
|
85
|
+
\`\`\`
|
|
86
|
+
cnotes text-search <pattern> [options]
|
|
87
|
+
\`\`\`
|
|
88
|
+
|
|
89
|
+
## Arguments
|
|
90
|
+
|
|
91
|
+
| Argument | Description |
|
|
92
|
+
|----------|-------------|
|
|
93
|
+
| \`pattern\` | Text or regex pattern to search for |
|
|
94
|
+
|
|
95
|
+
## Options
|
|
96
|
+
|
|
97
|
+
| Option | Default | Description |
|
|
98
|
+
|--------|---------|-------------|
|
|
99
|
+
| \`--expanded\` | \`false\` | Show line-level matches instead of just file paths |
|
|
100
|
+
| \`--include\` | | Glob filter for file types (e.g. \`"*.md"\`) |
|
|
101
|
+
| \`--exclude\` | | Glob filter to exclude (e.g. \`"node_modules"\`) |
|
|
102
|
+
| \`--ignoreCase\` | \`false\` | Case-insensitive matching |
|
|
103
|
+
| \`--maxResults\` | | Limit number of results |
|
|
104
|
+
| \`--contentFolder\` | | Path to content folder |
|
|
105
|
+
|
|
106
|
+
## Examples
|
|
107
|
+
|
|
108
|
+
\`\`\`bash
|
|
109
|
+
# Find files containing "authentication"
|
|
110
|
+
cnotes text-search authentication
|
|
111
|
+
|
|
112
|
+
# Case-insensitive search with line details
|
|
113
|
+
cnotes text-search "TODO" --ignoreCase --expanded
|
|
114
|
+
|
|
115
|
+
# Search only markdown files
|
|
116
|
+
cnotes text-search "status: draft" --include "*.md"
|
|
117
|
+
|
|
118
|
+
# Limit results
|
|
119
|
+
cnotes text-search "import" --maxResults 10 --expanded
|
|
120
|
+
\`\`\`
|
|
121
|
+
`,
|
|
122
|
+
argsSchema,
|
|
123
|
+
handler,
|
|
124
|
+
});
|
|
125
|
+
//# sourceMappingURL=text-search.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"text-search.js","sourceRoot":"","sources":["../../../src/cli/commands/text-search.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":""}
|