npm - contentbase - Versions diffs - 0.0.2 → 0.0.5 - Mend

contentbase 0.0.2 → 0.0.5

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

Files changed (130) hide show

package/CLI.md +593 -0
package/MCP-SERVER-SPEC.md +453 -0
package/PRIMER.md +540 -0
package/README.md +289 -13
package/docs/README.md +110 -0
package/docs/TABLE-OF-CONTENTS.md +7 -0
package/docs/models.ts +38 -0
package/models.ts +38 -0
package/package.json +12 -3
package/src/api/endpoints/actions.ts +34 -0
package/src/api/endpoints/doc.ts +187 -0
package/src/api/endpoints/docs-index.ts +26 -0
package/src/api/endpoints/document.ts +171 -0
package/src/api/endpoints/documents.ts +71 -0
package/src/api/endpoints/inspect.ts +16 -0
package/src/api/endpoints/models.ts +10 -0
package/src/api/endpoints/query.ts +88 -0
package/src/api/endpoints/root.ts +7 -0
package/src/api/endpoints/search-reindex.ts +65 -0
package/src/api/endpoints/search-status.ts +55 -0
package/src/api/endpoints/search.ts +104 -0
package/src/api/endpoints/semantic-search.ts +120 -0
package/src/api/endpoints/text-search.ts +63 -0
package/src/api/endpoints/validate.ts +34 -0
package/src/api/helpers.ts +97 -0
package/src/base-model.ts +12 -0
package/src/cli/commands/action.ts +82 -44
package/src/cli/commands/console.ts +124 -0
package/src/cli/commands/create.ts +179 -53
package/src/cli/commands/embed.ts +323 -0
package/src/cli/commands/export.ts +58 -24
package/src/cli/commands/extract.ts +174 -0
package/src/cli/commands/help.ts +81 -0
package/src/cli/commands/index.ts +17 -0
package/src/cli/commands/init.ts +72 -48
package/src/cli/commands/inspect.ts +56 -46
package/src/cli/commands/mcp.ts +1219 -0
package/src/cli/commands/search.ts +285 -0
package/src/cli/commands/serve.ts +348 -0
package/src/cli/commands/summary.ts +60 -0
package/src/cli/commands/teach.ts +86 -0
package/src/cli/commands/text-search.ts +134 -0
package/src/cli/commands/validate.ts +126 -64
package/src/cli/index.ts +88 -19
package/src/cli/load-collection.ts +144 -17
package/src/cli/registry.ts +28 -0
package/src/collection.ts +361 -10
package/src/define-model.ts +101 -4
package/src/document.ts +47 -1
package/src/extract-sections.ts +1 -1
package/src/index.ts +14 -2
package/src/model-instance.ts +35 -5
package/src/node-shortcuts.ts +1 -1
package/src/query/collection-query.ts +96 -9
package/src/query/index.ts +7 -0
package/src/query/query-dsl.ts +259 -0
package/src/relationships/has-many.ts +39 -0
package/src/relationships/index.ts +7 -2
package/src/section.ts +2 -0
package/src/types.ts +23 -1
package/src/utils/index.ts +1 -0
package/src/utils/match-pattern.ts +65 -0
package/src/validator.ts +18 -1
package/bun.lock +0 -473
package/examples/sdlc-queries.ts +0 -161
package/scripts/examples/01-collection-setup.ts +0 -46
package/scripts/examples/02-querying.ts +0 -67
package/scripts/examples/03-sections.ts +0 -36
package/scripts/examples/04-relationships.ts +0 -54
package/scripts/examples/05-document-api.ts +0 -54
package/scripts/examples/06-extract-sections.ts +0 -55
package/scripts/examples/07-validation.ts +0 -46
package/scripts/examples/08-serialization.ts +0 -51
package/scripts/examples/lib/format.ts +0 -87
package/scripts/examples/lib/setup.ts +0 -21
package/scripts/examples/run-all.ts +0 -43
package/showcases/national-parks/models.ts +0 -74
package/showcases/national-parks/parks/acadia.mdx +0 -40
package/showcases/national-parks/parks/yosemite.mdx +0 -44
package/showcases/national-parks/parks/zion.mdx +0 -44
package/showcases/national-parks/queries.ts +0 -103
package/showcases/national-parks/trails/angels-landing.mdx +0 -19
package/showcases/national-parks/trails/cathedral-lakes.mdx +0 -19
package/showcases/national-parks/trails/half-dome.mdx +0 -19
package/showcases/national-parks/trails/jordan-pond-path.mdx +0 -19
package/showcases/national-parks/trails/mist-trail.mdx +0 -19
package/showcases/national-parks/trails/observation-point.mdx +0 -19
package/showcases/national-parks/trails/precipice-trail.mdx +0 -19
package/showcases/national-parks/trails/the-narrows.mdx +0 -19
package/showcases/recipes/cuisines/chinese.mdx +0 -28
package/showcases/recipes/cuisines/italian.mdx +0 -32
package/showcases/recipes/cuisines/mexican.mdx +0 -28
package/showcases/recipes/models.ts +0 -77
package/showcases/recipes/queries.ts +0 -89
package/showcases/recipes/recipes/chinese/egg-fried-rice.mdx +0 -43
package/showcases/recipes/recipes/chinese/mapo-tofu.mdx +0 -47
package/showcases/recipes/recipes/italian/bruschetta.mdx +0 -38
package/showcases/recipes/recipes/italian/cacio-e-pepe.mdx +0 -39
package/showcases/recipes/recipes/italian/tiramisu.mdx +0 -43
package/showcases/recipes/recipes/mexican/chicken-tinga.mdx +0 -44
package/showcases/recipes/recipes/mexican/guacamole.mdx +0 -39
package/showcases/vinyl-collection/albums/bitches-brew.mdx +0 -36
package/showcases/vinyl-collection/albums/i-put-a-spell-on-you.mdx +0 -35
package/showcases/vinyl-collection/albums/in-rainbows.mdx +0 -35
package/showcases/vinyl-collection/albums/kind-of-blue.mdx +0 -32
package/showcases/vinyl-collection/albums/ok-computer.mdx +0 -37
package/showcases/vinyl-collection/albums/wild-is-the-wind.mdx +0 -35
package/showcases/vinyl-collection/artists/miles-davis.mdx +0 -27
package/showcases/vinyl-collection/artists/nina-simone.mdx +0 -26
package/showcases/vinyl-collection/artists/radiohead.mdx +0 -27
package/showcases/vinyl-collection/models.ts +0 -73
package/showcases/vinyl-collection/queries.ts +0 -87
package/test/ast-query.test.ts +0 -128
package/test/collection.test.ts +0 -99
package/test/define-model.test.ts +0 -78
package/test/document.test.ts +0 -225
package/test/extract-sections.test.ts +0 -356
package/test/fixtures/sdlc/epics/authentication.mdx +0 -42
package/test/fixtures/sdlc/epics/searching-and-browsing.mdx +0 -21
package/test/fixtures/sdlc/models.ts +0 -89
package/test/fixtures/sdlc/stories/authentication/a-user-should-be-able-to-register.mdx +0 -20
package/test/helpers.ts +0 -21
package/test/model-instance.test.ts +0 -197
package/test/query.test.ts +0 -167
package/test/relationships.test.ts +0 -84
package/test/section.test.ts +0 -99
package/test/table-of-contents.test.ts +0 -91
package/test/validator.test.ts +0 -62
package/tsconfig.json +0 -18
package/vitest.config.ts +0 -11

package/src/api/endpoints/doc.ts ADDED Viewed

@@ -0,0 +1,187 @@
+import matter from 'gray-matter'
+import { renderMarkdownToHtml, rewriteDocLinks } from '../helpers.js'
+export const path = '/docs/:docPath(.*)'
+export const description = 'Content-negotiated document serving (JSON, HTML, or Markdown)'
+export const tags = ['docs']
+export async function get(params: any, ctx: any) {
+  const collection = ctx.container._contentbaseCollection
+  let docPath: string = params.docPath || ''
+  // Determine format from extension or Accept header
+  let format = 'json'
+  if (docPath.endsWith('.json')) {
+    format = 'json'
+    docPath = docPath.slice(0, -5)
+  } else if (docPath.endsWith('.html')) {
+    format = 'html'
+    docPath = docPath.slice(0, -5)
+  } else if (docPath.endsWith('.md')) {
+    format = 'md'
+    docPath = docPath.slice(0, -3)
+  } else {
+    const accept = ctx.request.headers?.accept || ''
+    if (accept.includes('text/html')) format = 'html'
+    else if (accept.includes('text/markdown')) format = 'md'
+  }
+  if (!collection.available.includes(docPath)) {
+    ctx.response.status(404)
+    return { error: `Document not found: ${docPath}` }
+  }
+  const doc = collection.document(docPath)
+  const modelDef = collection.findModelDefinition(docPath)
+  switch (format) {
+    case 'md': {
+      const raw = matter.stringify(doc.content, doc.meta)
+      ctx.response.type('text/markdown')
+      ctx.response.send(raw)
+      return
+    }
+    case 'html': {
+      const html = rewriteDocLinks(await renderMarkdownToHtml(doc.content))
+      const page = `<!DOCTYPE html>
+<html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${doc.title}</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Fira+Code:wght@400;500;600&family=Inter:wght@400;500;600&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/atom-one-dark.min.css">
+<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"><\/script>
+<style>
+  *, *::before, *::after { box-sizing: border-box; }
+  body {
+    font-family: 'Inter', system-ui, -apple-system, sans-serif;
+    max-width: 52rem;
+    margin: 0 auto;
+    padding: 2rem 1.5rem;
+    line-height: 1.7;
+    color: #1a1a2e;
+    background: #fafafa;
+  }
+  h1 { font-size: 2rem; font-weight: 600; margin: 2rem 0 1rem; color: #0f0f23; }
+  h2 { font-size: 1.5rem; font-weight: 600; margin: 2.5rem 0 0.75rem; color: #16163a; border-bottom: 1px solid #e2e2e8; padding-bottom: 0.4rem; }
+  h3 { font-size: 1.2rem; font-weight: 600; margin: 2rem 0 0.5rem; color: #1a1a2e; }
+  h4, h5, h6 { font-weight: 600; margin: 1.5rem 0 0.5rem; }
+  p { margin: 0 0 1rem; }
+  a { color: #2563eb; text-decoration: none; }
+  a:hover { text-decoration: underline; }
+  blockquote {
+    border-left: 3px solid #6366f1;
+    margin: 1rem 0;
+    padding: 0.5rem 1rem;
+    background: #f0f0ff;
+    color: #3730a3;
+    border-radius: 0 6px 6px 0;
+  }
+  blockquote p { margin: 0; }
+  code {
+    font-family: 'Fira Code', 'Cascadia Code', 'JetBrains Mono', monospace;
+    font-feature-settings: "liga" 1, "calt" 1;
+    -webkit-font-feature-settings: "liga" 1, "calt" 1;
+    font-size: 0.875em;
+    background: #ededf0;
+    padding: 0.15em 0.4em;
+    border-radius: 4px;
+    color: #d6336c;
+  }
+  pre {
+    margin: 1rem 0;
+    border-radius: 8px;
+    overflow: hidden;
+    background: #282c34;
+    box-shadow: 0 2px 8px rgba(0,0,0,0.12);
+  }
+  pre code {
+    display: block;
+    padding: 1.25rem 1.5rem;
+    overflow-x: auto;
+    font-size: 0.9rem;
+    line-height: 1.6;
+    background: none;
+    color: #abb2bf;
+    border-radius: 0;
+  }
+  pre code .hljs-comment { font-style: italic; }
+  ul, ol { padding-left: 1.5rem; margin: 0.5rem 0 1rem; }
+  li { margin: 0.3rem 0; }
+  li > ul, li > ol { margin: 0.2rem 0; }
+  table { border-collapse: collapse; width: 100%; margin: 1rem 0; }
+  th { background: #f0f0f5; font-weight: 600; text-align: left; }
+  td, th { border: 1px solid #ddd; padding: 0.6em 0.8em; font-size: 0.95rem; }
+  tr:nth-child(even) { background: #f8f8fb; }
+  hr { border: none; border-top: 1px solid #e2e2e8; margin: 2rem 0; }
+  img { max-width: 100%; height: auto; border-radius: 6px; }
+  .meta-header { color: #6b7280; font-size: 0.85rem; margin-bottom: 2rem; padding-bottom: 1rem; border-bottom: 1px solid #e2e2e8; }
+  .meta-header span { margin-right: 1.5rem; }
+</style>
+</head>
+<body>
+${doc.meta && Object.keys(doc.meta).length > 0 ? `<div class="meta-header">${Object.entries(doc.meta).filter(([k]) => k !== 'title').map(([k, v]) => `<span><strong>${k}:</strong> ${v}</span>`).join('')}</div>` : ''}
+${html}
+<script>hljs.highlightAll();<\/script>
+</body></html>`
+      ctx.response.type('text/html')
+      ctx.response.send(page)
+      return
+    }
+    default: {
+      const result: Record<string, unknown> = {
+        id: doc.id,
+        title: doc.title,
+        meta: doc.meta,
+        content: doc.content,
+        outline: doc.toOutline(),
+        model: modelDef?.name || null,
+        createdAt: doc.createdAt,
+        updatedAt: doc.updatedAt,
+        size: doc.size,
+      }
+      if (modelDef) {
+        const instance = collection.getModel(docPath, modelDef)
+        const sectionKeys = modelDef.sections ? Object.keys(modelDef.sections) : []
+        const computedKeys = modelDef.computed ? Object.keys(modelDef.computed) : []
+        const relationshipKeys = modelDef.relationships ? Object.keys(modelDef.relationships) : []
+        if (sectionKeys.length) {
+          result.sections = {}
+          for (const key of sectionKeys) {
+            try {
+              (result.sections as any)[key] = instance.sections[key]
+            } catch {}
+          }
+        }
+        if (computedKeys.length) {
+          result.computed = {}
+          for (const key of computedKeys) {
+            try {
+              (result.computed as any)[key] = instance.computed[key]
+            } catch {}
+          }
+        }
+        if (relationshipKeys.length) {
+          result.relationships = {}
+          for (const key of relationshipKeys) {
+            try {
+              const rel = (instance.relationships as any)[key]
+              if ('fetchAll' in rel) {
+                (result.relationships as any)[key] = rel.fetchAll().map((i: any) => ({ id: i.id, title: i.title }))
+              } else if ('fetch' in rel) {
+                const parent = rel.fetch()
+                (result.relationships as any)[key] = parent ? { id: parent.id, title: parent.title } : null
+              }
+            } catch {}
+          }
+        }
+      }
+      return result
+    }
+  }
+}

package/src/api/endpoints/docs-index.ts ADDED Viewed

@@ -0,0 +1,26 @@
+import { renderTocPage } from '../helpers.js'
+export const path = '/docs'
+export const description = 'Table of contents for all documents'
+export const tags = ['docs']
+export async function get(_params: any, ctx: any) {
+  const collection = ctx.container._contentbaseCollection
+  const accept = ctx.request.headers?.accept || ''
+  if (accept.includes('text/html') || !accept.includes('application/json')) {
+    const page = await renderTocPage(collection)
+    ctx.response.type('text/html')
+    ctx.response.send(page)
+    return
+  }
+  return {
+    title: 'Table of Contents',
+    documents: collection.available.map((id: string) => {
+      const doc = collection.document(id)
+      const modelDef = collection.findModelDefinition(id)
+      return { id, title: doc.title, model: modelDef?.name || null }
+    })
+  }
+}

package/src/api/endpoints/document.ts ADDED Viewed

@@ -0,0 +1,171 @@
+import { z } from 'zod'
+import matter from 'gray-matter'
+export const path = '/api/documents/:pathId(.*)'
+export const description = 'CRUD operations on a single document'
+export const tags = ['documents']
+export async function get(params: any, ctx: any) {
+  const collection = ctx.container._contentbaseCollection
+  const pathId = params.pathId
+  if (!collection.available.includes(pathId)) {
+    ctx.response.status(404)
+    return { error: `Document not found: ${pathId}` }
+  }
+  const doc = collection.document(pathId)
+  const modelDef = collection.findModelDefinition(pathId)
+  const result: Record<string, unknown> = {
+    id: doc.id,
+    title: doc.title,
+    meta: doc.meta,
+    content: doc.content,
+    outline: doc.toOutline(),
+    model: modelDef?.name || null,
+  }
+  if (modelDef) {
+    const instance = collection.getModel(pathId, modelDef)
+    const sectionKeys = modelDef.sections ? Object.keys(modelDef.sections) : []
+    const computedKeys = modelDef.computed ? Object.keys(modelDef.computed) : []
+    const relationshipKeys = modelDef.relationships ? Object.keys(modelDef.relationships) : []
+    if (sectionKeys.length) {
+      result.sections = {}
+      for (const key of sectionKeys) {
+        try {
+          (result.sections as any)[key] = instance.sections[key]
+        } catch {}
+      }
+    }
+    if (computedKeys.length) {
+      result.computed = {}
+      for (const key of computedKeys) {
+        try {
+          (result.computed as any)[key] = instance.computed[key]
+        } catch {}
+      }
+    }
+    if (relationshipKeys.length) {
+      result.relationships = {}
+      for (const key of relationshipKeys) {
+        try {
+          const rel = (instance.relationships as any)[key]
+          if ('fetchAll' in rel) {
+            (result.relationships as any)[key] = rel.fetchAll().map((i: any) => ({ id: i.id, title: i.title }))
+          } else if ('fetch' in rel) {
+            const parent = rel.fetch()
+            (result.relationships as any)[key] = parent ? { id: parent.id, title: parent.title } : null
+          }
+        } catch {}
+      }
+    }
+  }
+  return result
+}
+export const putSchema = z.object({
+  meta: z.record(z.string(), z.any()).optional(),
+  content: z.string().optional(),
+})
+export async function put(params: any, ctx: any) {
+  if (ctx.container._contentbaseReadOnly) {
+    ctx.response.status(403)
+    return { error: 'Server is running in read-only mode' }
+  }
+  const collection = ctx.container._contentbaseCollection
+  const pathId = ctx.params.pathId
+  if (!collection.available.includes(pathId)) {
+    ctx.response.status(404)
+    return { error: `Document not found: ${pathId}` }
+  }
+  const doc = collection.document(pathId)
+  const currentMeta = { ...doc.meta }
+  const newMeta = params.meta ? { ...currentMeta, ...params.meta } : currentMeta
+  const newContent = params.content ?? doc.content
+  const fullContent = matter.stringify(newContent, newMeta)
+  await collection.saveItem(pathId, { content: fullContent })
+  return { updated: pathId, meta: newMeta }
+}
+export const patchSchema = z.object({
+  heading: z.string(),
+  action: z.enum(['replace', 'append', 'remove']),
+  content: z.string().optional(),
+})
+export async function patch(params: any, ctx: any) {
+  if (ctx.container._contentbaseReadOnly) {
+    ctx.response.status(403)
+    return { error: 'Server is running in read-only mode' }
+  }
+  const collection = ctx.container._contentbaseCollection
+  const pathId = ctx.params.pathId
+  if (!collection.available.includes(pathId)) {
+    ctx.response.status(404)
+    return { error: `Document not found: ${pathId}` }
+  }
+  let doc = collection.document(pathId)
+  switch (params.action) {
+    case 'replace': {
+      if (!params.content) {
+        ctx.response.status(400)
+        return { error: 'Content is required for replace action' }
+      }
+      doc = doc.replaceSectionContent(params.heading, params.content)
+      break
+    }
+    case 'append': {
+      if (!params.content) {
+        ctx.response.status(400)
+        return { error: 'Content is required for append action' }
+      }
+      doc = doc.appendToSection(params.heading, params.content)
+      break
+    }
+    case 'remove': {
+      doc = doc.removeSection(params.heading)
+      break
+    }
+  }
+  const fullContent = matter.stringify(doc.content, doc.meta)
+  await collection.saveItem(pathId, { content: fullContent })
+  return { updated: pathId, action: params.action, heading: params.heading }
+}
+async function del(_params: any, ctx: any) {
+  if (ctx.container._contentbaseReadOnly) {
+    ctx.response.status(403)
+    return { error: 'Server is running in read-only mode' }
+  }
+  const collection = ctx.container._contentbaseCollection
+  const pathId = ctx.params.pathId
+  if (!collection.available.includes(pathId)) {
+    ctx.response.status(404)
+    return { error: `Document not found: ${pathId}` }
+  }
+  await collection.deleteItem(pathId)
+  return { deleted: pathId }
+}
+export { del as delete }

package/src/api/endpoints/documents.ts ADDED Viewed

@@ -0,0 +1,71 @@
+import { z } from 'zod'
+import matter from 'gray-matter'
+import { resolveModelDef } from '../helpers.js'
+export const path = '/api/documents'
+export const description = 'List or create documents'
+export const tags = ['documents']
+export const getSchema = z.object({
+  model: z.string().optional(),
+})
+export async function get(params: any, ctx: any) {
+  const collection = ctx.container._contentbaseCollection
+  let ids = collection.available as string[]
+  if (params.model) {
+    const def = resolveModelDef(collection, params.model)
+    if (!def) {
+      ctx.response.status(400)
+      return { error: `Unknown model: ${params.model}` }
+    }
+    const prefix = (def as any).prefix + '/'
+    ids = ids.filter((id: string) => id.startsWith(prefix))
+  }
+  return ids.map((id: string) => {
+    const doc = collection.document(id)
+    return { id, title: doc.title, meta: doc.meta, size: doc.size, createdAt: doc.createdAt, updatedAt: doc.updatedAt }
+  })
+}
+export const postSchema = z.object({
+  pathId: z.string(),
+  title: z.string(),
+  meta: z.record(z.string(), z.any()).optional(),
+  model: z.string().optional(),
+})
+export async function post(params: any, ctx: any) {
+  if (ctx.container._contentbaseReadOnly) {
+    ctx.response.status(403)
+    return { error: 'Server is running in read-only mode' }
+  }
+  const collection = ctx.container._contentbaseCollection
+  if (collection.available.includes(params.pathId)) {
+    ctx.response.status(409)
+    return { error: `Document already exists: ${params.pathId}` }
+  }
+  const def = params.model
+    ? resolveModelDef(collection, params.model)
+    : collection.findModelDefinition(params.pathId)
+  const metaData = { ...((def as any)?.defaults || {}), ...(params.meta || {}) }
+  const sectionHeadings = def
+    ? Object.values((def as any).sections || {}).map((s: any) => `## ${s.heading}\n\n`)
+    : []
+  const body = [`# ${params.title}`, '', ...sectionHeadings].join('\n')
+  const content = matter.stringify(body, metaData)
+  await collection.saveItem(params.pathId, { content })
+  ctx.response.status(201)
+  return { created: params.pathId, model: def ? (def as any).name : null, meta: metaData }
+}

package/src/api/endpoints/inspect.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { buildSchemaJSON } from '../helpers.js'
+export const path = '/api/inspect'
+export const description = 'Collection overview — models, document count, actions'
+export const tags = ['collection']
+export async function get(_params: any, ctx: any) {
+  const collection = ctx.container._contentbaseCollection
+  const schema = buildSchemaJSON(collection)
+  return {
+    rootPath: collection.rootPath,
+    documentCount: collection.available.length,
+    models: Object.values(schema),
+    actions: collection.availableActions,
+  }
+}

package/src/api/endpoints/models.ts ADDED Viewed

@@ -0,0 +1,10 @@
+import { buildSchemaJSON } from '../helpers.js'
+export const path = '/api/models'
+export const description = 'All model definitions with schemas, sections, and relationships'
+export const tags = ['collection']
+export async function get(_params: any, ctx: any) {
+  const collection = ctx.container._contentbaseCollection
+  return buildSchemaJSON(collection)
+}

package/src/api/endpoints/query.ts ADDED Viewed

@@ -0,0 +1,88 @@
+import { z } from 'zod'
+import { resolveModelDef } from '../helpers.js'
+import { queryDSLSchema, executeQueryDSL } from '../../query/query-dsl.js'
+export const path = '/api/query'
+export const description = 'Query model instances with filtering'
+export const tags = ['query']
+export const getSchema = z.object({
+  model: z.string(),
+  where: z.string().optional(),
+  select: z.string().optional(),
+  related: z.string().optional(),
+})
+export const postSchema = queryDSLSchema
+export async function get(params: any, ctx: any) {
+  const collection = ctx.container._contentbaseCollection
+  const def = resolveModelDef(collection, params.model)
+  if (!def) {
+    ctx.response.status(400)
+    return { error: `Unknown model: ${params.model}` }
+  }
+  let q = collection.query(def)
+  if (params.where) {
+    let conditions: any[]
+    try {
+      conditions = JSON.parse(params.where)
+    } catch {
+      ctx.response.status(400)
+      return { error: 'Invalid JSON in where parameter' }
+    }
+    for (const condition of conditions) {
+      const { path: fieldPath, operator = 'eq', value } = condition
+      switch (operator) {
+        case 'eq': q = q.where(fieldPath, value); break
+        case 'in': q = q.whereIn(fieldPath, value); break
+        case 'notIn': q = q.whereNotIn(fieldPath, value); break
+        case 'gt': q = q.whereGt(fieldPath, value); break
+        case 'lt': q = q.whereLt(fieldPath, value); break
+        case 'gte': q = q.whereGte(fieldPath, value); break
+        case 'lte': q = q.whereLte(fieldPath, value); break
+        case 'contains': q = q.whereContains(fieldPath, value); break
+        case 'startsWith': q = q.whereStartsWith(fieldPath, value); break
+        case 'endsWith': q = q.whereEndsWith(fieldPath, value); break
+        case 'regex': q = q.whereRegex(fieldPath, value); break
+        case 'exists': q = q.whereExists(fieldPath); break
+        case 'notExists': q = q.whereNotExists(fieldPath); break
+      }
+    }
+  }
+  const results = await q.fetchAll()
+  const selectFields = params.select ? params.select.split(',').map((s: string) => s.trim()) : null
+  const relatedFields = params.related ? params.related.split(',').map((s: string) => s.trim()) : undefined
+  return results.map((instance: any) => {
+    const json = instance.toJSON({ related: relatedFields })
+    if (selectFields && selectFields.length > 0) {
+      const filtered: Record<string, any> = {}
+      for (const key of selectFields) {
+        if (key in json) filtered[key] = json[key]
+        else if (key.startsWith('meta.') && json.meta) {
+          filtered[key] = json.meta[key.slice(5)]
+        }
+      }
+      return filtered
+    }
+    return json
+  })
+}
+export async function post(params: any, ctx: any) {
+  const collection = ctx.container._contentbaseCollection
+  try {
+    const dsl = queryDSLSchema.parse(params)
+    return await executeQueryDSL(collection, dsl)
+  } catch (error: any) {
+    ctx.response.status(400)
+    return { error: error.message }
+  }
+}

package/src/api/endpoints/root.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export const path = '/'
+export const description = 'Redirect to docs table of contents when no static index.html exists'
+export const tags = ['docs']
+export async function get(_params: any, ctx: any) {
+  ctx.response.redirect('/docs/')
+}

package/src/api/endpoints/search-reindex.ts ADDED Viewed

@@ -0,0 +1,65 @@
+import { z } from 'zod'
+import pathModule from 'node:path'
+export const path = '/api/search/reindex'
+export const description = 'Trigger search index rebuild'
+export const tags = ['mutation']
+export const postSchema = z.object({
+  pathIds: z.array(z.string()).optional(),
+  force: z.boolean().optional(),
+})
+export async function post(params: any, ctx: any) {
+  const collection = ctx.container._contentbaseCollection
+  const rootPath = collection.rootPath
+  const { SemanticSearch } = await import('@soederpop/luca/agi')
+  if (!ctx.container.features.available.includes('semanticSearch')) {
+    SemanticSearch.attach(ctx.container)
+  }
+  const dbPath = pathModule.join(rootPath, '.contentbase/search.sqlite')
+  const ss = ctx.container.feature('semanticSearch', { dbPath })
+  await ss.initDb()
+  if (params.pathIds) {
+    await ss.reindex(params.pathIds)
+  } else if (params.force) {
+    await ss.reindex()
+  }
+  // Collect and re-index documents
+  const docs: any[] = []
+  const targetIds = params.pathIds || collection.available
+  for (const pathId of targetIds) {
+    if (!collection.available.includes(pathId)) continue
+    const doc = collection.document(pathId)
+    const modelDef = collection.findModelDefinition(pathId)
+    docs.push({
+      pathId,
+      model: modelDef?.name ?? undefined,
+      title: doc.title,
+      slug: doc.slug,
+      meta: doc.meta,
+      content: doc.content,
+    })
+  }
+  const toIndex = params.force ? docs : docs.filter((d: any) => ss.needsReindex(d))
+  if (toIndex.length > 0) {
+    await ss.indexDocuments(toIndex)
+  }
+  ss.removeStale(collection.available)
+  const stats = ss.getStats()
+  return {
+    reindexed: toIndex.length,
+    total: docs.length,
+    ...stats,
+  }
+}