mirror of
https://github.com/vectorize-io/hindsight.git
synced 2026-09-14 19:31:49 +08:00
Nicolò Boschi
4d22a882f5
* docs(knowledge-pages): document Knowledge Pages and Mental Models Knowledge Pages shipped in #2455 with no documentation at all — no architecture page, no API page, no mention in the sidebar. Mental models had an API page but nothing explaining what they are or why they are fast. Add both, as top-level entries under Architecture and API. - Architecture: how pages are mental models with a simplified, document-shaped configuration; the folder hierarchy; the `hindsight fs` filesystem projection; page-level search; and why a projected view over reconciled memory is not the same thing as a folder of raw files. - Architecture: mental models as standing answers built in the background, so an application reads the current version instead of paying for synthesis on the request path. - API: the full knowledge-base endpoint surface, the page defaults and what each one buys, staleness gating, what a refresh reads, and how delta mode edits a structured document instead of regenerating prose. The mental-model trigger table gains the seven settings it was missing. - FAQ: mental model vs knowledge page. Also corrects the neighbouring answer, which described mental models as built automatically during retain — that is observations. The API examples use the maintained clients like every other API page, so this adds the knowledge-base surface to the Python and TypeScript wrappers (kept at parity, with request-mapping tests on both sides) and runnable Python/Node/Go examples. * feat(cli): manage knowledge pages from the CLI The knowledge base was reachable from every client except the CLI, where the eight endpoints were listed as deliberate coverage skips ("managed in the control plane UI"). That left `hindsight fs` able to mirror pages read-only but nothing able to create, edit, search, or delete them — and it meant the API docs could not show a CLI tab alongside Python/Node/Go. Adds `hindsight knowledge-base` with tree, create-folder, create-page, get-page, search, update, delete, and export, removing the skips so cli-coverage-check enforces the surface from here on. `create-page` sends no trigger unless --mode or --fact-types is passed, so the server's page defaults stand; when either is given the whole trigger has to be restated, because a supplied trigger replaces the defaults rather than merging with them. Also adds the CLI tab to the Knowledge Pages API page and a Knowledge Base section to the CLI reference.
406 lines
11 KiB
TypeScript
406 lines
11 KiB
TypeScript
import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
|
|
|
|
const sidebars: SidebarsConfig = {
|
|
developerSidebar: [
|
|
{
|
|
type: 'category',
|
|
label: 'Architecture',
|
|
collapsible: false,
|
|
items: [
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/index',
|
|
label: 'Overview',
|
|
customProps: { icon: 'lu-book' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/retain',
|
|
label: 'Retain',
|
|
customProps: { icon: 'lu-brain' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/retrieval',
|
|
label: 'Recall',
|
|
customProps: { icon: 'lu-search' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/reflect',
|
|
label: 'Reflect',
|
|
customProps: { icon: 'lu-message' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/observations',
|
|
label: 'Observations',
|
|
customProps: { icon: 'lu-activity' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/mental-models',
|
|
label: 'Mental Models',
|
|
customProps: { icon: 'lu-layers' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/knowledge-pages',
|
|
label: 'Knowledge Pages',
|
|
customProps: { icon: 'lu-book-text' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/multilingual',
|
|
label: 'Multilingual',
|
|
customProps: { icon: 'lu-languages' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/performance',
|
|
label: 'Performance',
|
|
customProps: { icon: 'lu-zap' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/storage',
|
|
label: 'Storage',
|
|
customProps: { icon: 'lu-database' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/rag-vs-hindsight',
|
|
label: 'RAG vs Memory',
|
|
customProps: { icon: 'lu-compare' },
|
|
},
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'API',
|
|
collapsible: false,
|
|
items: [
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/quickstart',
|
|
label: 'Quick Start',
|
|
customProps: { icon: 'lu-rocket' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/retain',
|
|
label: 'Retain',
|
|
customProps: { icon: 'lu-brain' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/recall',
|
|
label: 'Recall',
|
|
customProps: { icon: 'lu-search' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/reflect',
|
|
label: 'Reflect',
|
|
customProps: { icon: 'lu-message' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/mental-models',
|
|
label: 'Mental Models',
|
|
customProps: { icon: 'lu-layers' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/knowledge-pages',
|
|
label: 'Knowledge Pages',
|
|
customProps: { icon: 'lu-book-text' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/memories',
|
|
label: 'Memories',
|
|
customProps: { icon: 'lu-eraser' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/memory-banks',
|
|
label: 'Memory Banks',
|
|
customProps: { icon: 'lu-memory' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/documents',
|
|
label: 'Documents',
|
|
customProps: { icon: 'lu-file' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/operations',
|
|
label: 'Operations',
|
|
customProps: { icon: 'lu-cpu' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/webhooks',
|
|
label: 'Webhooks',
|
|
customProps: { icon: 'lu-webhook' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/api/bank-templates',
|
|
label: 'Bank Templates',
|
|
customProps: { icon: 'lu-file-json' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: '/api-reference',
|
|
label: 'API Reference',
|
|
customProps: { icon: 'lu-book-open', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'Security',
|
|
collapsible: false,
|
|
items: [
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/memory-defense/index',
|
|
label: 'Memory Defense',
|
|
customProps: { icon: 'lu-shield' },
|
|
},
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'Clients',
|
|
collapsible: false,
|
|
items: [
|
|
{
|
|
type: 'doc',
|
|
id: 'sdks/python',
|
|
label: 'Python',
|
|
customProps: { icon: 'si-python' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'sdks/nodejs',
|
|
label: 'TypeScript',
|
|
customProps: { icon: '/img/icons/typescript.png' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'sdks/go',
|
|
label: 'Go',
|
|
customProps: { icon: 'si-go' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'sdks/cli',
|
|
label: 'CLI',
|
|
customProps: { icon: 'lu-terminal' },
|
|
},
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'Integrations',
|
|
collapsible: false,
|
|
// Positional placeholder. The real items are injected at render time from
|
|
// src/data/integrations.json by the swizzled DocPage/Layout/Sidebar
|
|
// component — single source of truth, shared across all docs versions.
|
|
// (Docusaurus rejects an empty category, so we seed one valid link to the
|
|
// gallery; the component replaces these items.)
|
|
items: [{type: 'link', href: '/integrations', label: 'Browse all integrations'}],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'Hosting',
|
|
collapsible: false,
|
|
items: [
|
|
{
|
|
type: 'link',
|
|
href: 'https://ui.hindsight.vectorize.io/signup',
|
|
label: 'Cloud',
|
|
customProps: { icon: 'lu-cloud', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/installation',
|
|
label: 'Installation',
|
|
customProps: { icon: 'lu-package' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/services',
|
|
label: 'Services',
|
|
customProps: { icon: 'lu-server' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/configuration',
|
|
label: 'Configuration',
|
|
customProps: { icon: 'lu-settings' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/admin-cli',
|
|
label: 'Admin CLI',
|
|
customProps: { icon: 'lu-terminal' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/oracle',
|
|
label: 'Oracle Database',
|
|
customProps: { icon: 'lu-database' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/extensions',
|
|
label: 'Extensions',
|
|
customProps: { icon: 'lu-plug' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/models',
|
|
label: 'Models',
|
|
customProps: { icon: 'lu-cpu' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/monitoring',
|
|
label: 'Monitoring',
|
|
customProps: { icon: 'lu-activity' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'developer/mcp-server',
|
|
label: 'MCP Server',
|
|
customProps: { icon: 'lu-network' },
|
|
},
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'Installation',
|
|
collapsible: false,
|
|
items: [
|
|
{
|
|
type: 'link',
|
|
href: '/developer/installation#docker',
|
|
label: 'Docker',
|
|
customProps: { icon: 'si-docker', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: '/developer/installation#helm--kubernetes',
|
|
label: 'Kubernetes',
|
|
customProps: { icon: 'si-kubernetes', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: '/developer/installation#bare-metal-pip',
|
|
label: 'Bare Metal',
|
|
customProps: { icon: 'lu-hard-drive', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'sdks/hindsight-all',
|
|
label: 'Programmatic API (Python)',
|
|
customProps: { icon: 'si-python' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'sdks/hindsight-all-npm',
|
|
label: 'Programmatic API (Node.js)',
|
|
customProps: { icon: 'si-nodedotjs' },
|
|
},
|
|
{
|
|
type: 'doc',
|
|
id: 'sdks/embed',
|
|
label: 'Daemon CLI',
|
|
customProps: { icon: 'lu-terminal' },
|
|
},
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'Resources',
|
|
collapsible: false,
|
|
items: [
|
|
{
|
|
type: 'link',
|
|
href: '/templates',
|
|
label: 'Bank Templates Hub',
|
|
customProps: { icon: 'lu-layout-template', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: '/best-practices',
|
|
label: 'Best Practices',
|
|
customProps: { icon: 'lu-star', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: '/faq',
|
|
label: 'FAQ',
|
|
customProps: { icon: 'lu-circle-help', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'More',
|
|
collapsible: false,
|
|
items: [
|
|
{
|
|
type: 'link',
|
|
href: '/cookbook',
|
|
label: 'Cookbook',
|
|
customProps: { icon: 'lu-book', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: '/blog',
|
|
label: 'Blog',
|
|
customProps: { icon: 'lu-rss', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: 'https://join.slack.com/t/hindsight-space/shared_invite/zt-3nhbm4w29-LeSJ5Ixi6j8PdiYOCPlOgg',
|
|
label: 'Community',
|
|
customProps: { icon: 'si-slack', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: 'https://github.com/vectorize-io/hindsight',
|
|
label: 'GitHub',
|
|
customProps: { icon: 'si-github', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: 'https://benchmarks.hindsight.vectorize.io/',
|
|
label: 'Benchmarks',
|
|
customProps: { icon: 'lu-chart-bar', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: 'https://benchmarks.hindsight.vectorize.io/',
|
|
label: 'Which Model Should I Use?',
|
|
customProps: { icon: 'lu-cpu', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
{
|
|
type: 'link',
|
|
href: 'https://arxiv.org/abs/2512.12818',
|
|
label: 'Paper',
|
|
customProps: { icon: 'lu-file-text', iconAfter: 'lu-arrow-up-right' },
|
|
},
|
|
],
|
|
},
|
|
],
|
|
};
|
|
|
|
export default sidebars;
|