Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
PRD-7967 Present frontmatter schemas as stable (#3455)
serafin-garcia23a0f69292d6
diff --git a/.changeset/frontmatter-schemas-stable.md b/.changeset/frontmatter-schemas-stable.mdnew file mode 100644index 000000000..e41198cb6--- /dev/null+++ b/.changeset/frontmatter-schemas-stable.md@@ -0,0 +1,5 @@+---+"@inkeep/open-knowledge": patch+---++Frontmatter schemas are now presented as a stable feature throughout the app and documentation.diff --git a/docs/content/plugins/overview.mdx b/docs/content/plugins/overview.mdxindex 107bbd4aa..2dbb94702 100644--- a/docs/content/plugins/overview.mdx+++ b/docs/content/plugins/overview.mdx@@ -25,7 +25,7 @@ Flip the switch. Open editors react live; there is no restart and no Save button| Plugin | Scope | What it does || --- | --- | --- || [markdownlint](/docs/advanced/content-rules/markdownlint) | Project | Flags markdown style problems as you write — hard tabs, heading increments, list markers, and the rest of the standard rule set. |-| [Frontmatter schemas](/docs/advanced/content-rules/frontmatter) | Project | Validates document frontmatter against standard JSON Schema files. Beta. |+| [Frontmatter schemas](/docs/advanced/content-rules/frontmatter) | Project | Validates document frontmatter against standard JSON Schema files. || [Slidev](/docs/plugins/slidev) | User | Presents a document as a slide deck in its own window. Desktop only; needs the Slidev CLI installed separately. Beta. || [Themes](/docs/plugins/themes) | User | A personal color-theme picker: one palette per light mode and one per dark, built-in or your own base16 schemes. |diff --git a/packages/app/src/components/SchemaConfigEditor.dom.test.tsx b/packages/app/src/components/SchemaConfigEditor.dom.test.tsxindex 6529cf860..14ae7ecc2 100644--- a/packages/app/src/components/SchemaConfigEditor.dom.test.tsx+++ b/packages/app/src/components/SchemaConfigEditor.dom.test.tsx@@ -123,13 +123,12 @@ afterEach(() => {});describe('SchemaConfigEditor — toggle and default view', () => {- test('renders a Source/Fields toggle and defaults to the Source view', () => {+ test('renders a Source/Fields toggle without a maturity tag and defaults to Source', () => {renderEditor(MAPPED_SCHEMA);expect(fieldsSegment()).toBeDefined();expect(sourceSegment()).toBeDefined();- // The feature-beta tag marks the schema editor surface.- expect(screen.getByText('Beta')).toBeDefined();+ expect(screen.queryByText('Beta')).toBeNull();const viewer = screen.getByTestId('mock-text-viewer');expect(viewer.getAttribute('data-src')).toBe(diff --git a/packages/app/src/components/SchemaConfigEditor.tsx b/packages/app/src/components/SchemaConfigEditor.tsxindex 8aca30939..cf64a667a 100644--- a/packages/app/src/components/SchemaConfigEditor.tsx+++ b/packages/app/src/components/SchemaConfigEditor.tsx@@ -24,7 +24,6 @@ import { useEffect, useState } from 'react';import { EditorModeToggle } from '@/components/EditorModeToggle';import { NotInSidebarIndicator } from '@/components/NotInSidebarIndicator';import { FrontmatterSchemaFieldEditor } from '@/components/settings/frontmatter-schema-field-editor';-import { PluginBetaBadge } from '@/components/settings/PluginBetaBadge';import { TextViewer } from '@/components/TextViewer';import { useProjectLintConfig } from '@/editor/lint-config-client';import { type LintConfigViewMode, useLintConfigViewMode } from '@/editor/useLintConfigViewMode';@@ -94,7 +93,7 @@ export function SchemaConfigEditor({ assetPath }: SchemaConfigEditorProps) {entry={{ kind: 'asset', path: assetPath }}className="shrink-0 border-b bg-background px-3 py-1.5"/>- <div className="relative flex shrink-0 items-center justify-center border-b bg-background py-2">+ <div className="flex shrink-0 items-center justify-center border-b bg-background py-2"><EditorModeToggleisSourceMode={isSourceMode}onModeChange={(next) => setViewMode(next === 'source' ? 'source' : 'rules')}@@ -103,11 +102,6 @@ export function SchemaConfigEditor({ assetPath }: SchemaConfigEditorProps) {sourceLabel={t`Source`}wysiwygDisabledReason={t`Field editing is available for schema files mapped in the Frontmatter schemas plugin`}/>- {/* Absolute so the mode toggle stays visually centered. Denser than the- Badge default because this one sits in the editor toolbar beside the- mode toggle, not in a settings header — the settings surfaces use the- default so Beta and Scope badges line up. */}- <PluginBetaBadge className="absolute left-3 top-1/2 h-4 -translate-y-1/2 px-1 text-[10px]" /></div>{isSourceMode ? (// Source is a CodeMirror viewer that owns its own scroll — full-bleed,diff --git a/packages/app/src/components/settings/FrontmatterPluginSection.dom.test.tsx b/packages/app/src/components/settings/FrontmatterPluginSection.dom.test.tsxindex 9762a10d6..8955e8a5d 100644--- a/packages/app/src/components/settings/FrontmatterPluginSection.dom.test.tsx+++ b/packages/app/src/components/settings/FrontmatterPluginSection.dom.test.tsx@@ -273,10 +273,10 @@ describe('FrontmatterPluginSection — schema browser', () => {expect(consumeSchemaFieldsView('schemas/local.schema.json')).toBe(true);});- test('the section header carries the feature-beta tag', () => {+ test('the section header has no maturity tag', () => {renderSection();const header = document.getElementById('settings-plugin-frontmatter-title')?.parentElement;- expect(header?.textContent).toContain('Beta');+ expect(header?.textContent).not.toContain('Beta');});test('the appliesTo input names the pattern grammar with an example glob', () => {diff --git a/packages/app/src/components/settings/LintingSection.dom.test.tsx b/packages/app/src/components/settings/LintingSection.dom.test.tsxindex 3f4950d16..fe09ee58e 100644--- a/packages/app/src/components/settings/LintingSection.dom.test.tsx+++ b/packages/app/src/components/settings/LintingSection.dom.test.tsx@@ -178,11 +178,8 @@ describe('ProjectPluginsManageSection', () => {expect(screen.getByTestId('settings-plugins-audit-pointer').textContent).toContain('Run a project audit from the Problems panel',);- // The frontmatter plugin is feature-beta; markdownlint is not.const list = screen.getByTestId('settings-plugins-list');- const rows = within(list).getAllByText('Beta');- expect(rows).toHaveLength(1);- expect(rows[0]?.closest('label')?.textContent).toContain('Frontmatter schemas');+ expect(within(list).queryByText('Beta')).toBeNull();});test('every plugin toggle is described by its own row description', () => {@@ -328,10 +325,11 @@ describe('UserPluginsManageSection', () => {expect(window.location.hash).toBe('#settings/plugin:theme');});- test('lists a user-scope Slides toggle beside Themes', () => {+ test('lists a user-scope Slides toggle beside Themes and labels Slidev as beta', () => {render(<UserPluginsManageSection userBinding={null} />);expect(screen.getByTestId('settings-plugin-toggle-slides')).toBeDefined();expect(screen.getByTestId('settings-plugin-toggle-theme')).toBeDefined();+ expect(screen.getByText('Slidev').closest('label')?.textContent).toContain('Beta');});test('enabling Slides writes the user-scope enabled patch and offers its panel', async () => {diff --git a/packages/app/src/components/settings/LintingSection.tsx b/packages/app/src/components/settings/LintingSection.tsxindex c61fda337..0ede8d5b3 100644--- a/packages/app/src/components/settings/LintingSection.tsx+++ b/packages/app/src/components/settings/LintingSection.tsx@@ -140,7 +140,6 @@ export function ProjectPluginsManageSection() {className="inline-flex items-center gap-1.5 text-sm font-medium">{plugin.label}- {plugin.id === 'frontmatter' ? <PluginBetaBadge /> : null}</Label><p id={descriptionId} className="text-1sm text-muted-foreground"><PluginManageDescription id={plugin.id} />@@ -715,7 +714,6 @@ export function FrontmatterPluginSection() {<PluginSectionHeadertitleId="settings-plugin-frontmatter-title"title={t`Frontmatter schemas`}- betadocUrl={pluginDocUrl('frontmatter')}><Trans>diff --git a/packages/app/src/components/settings/PluginBetaBadge.tsx b/packages/app/src/components/settings/PluginBetaBadge.tsxindex 28c32f2c2..6528f8dfe 100644--- a/packages/app/src/components/settings/PluginBetaBadge.tsx+++ b/packages/app/src/components/settings/PluginBetaBadge.tsx@@ -1,8 +1,6 @@/**- * Feature-maturity "Beta" tag for a plugin — always visible, about the feature,- * not the build (mirrors the ACP AgentBetaBadge). Rendered on every surface the- * feature owns: the Plugins manage row, the plugin's settings panel header, and- * (for frontmatter schemas) the schema file editor.+ * Feature-maturity "Beta" tag for a plugin — about the feature, not the build+ * (mirrors the ACP AgentBetaBadge). Render it on every surface a beta plugin owns.** Sizing is the `Badge` default on purpose. This badge used to hard-code a* smaller `h-4 px-1 text-[10px]`, which is invisible while a header carries only@@ -10,16 +8,14 @@* `ScopeBadge`, which uses the default, and the pair came out visibly mismatched.* `Badge` has no size variant, so the smaller values were a one-off override;* the default is the design-system size every other badge in the app uses.- * Callers that genuinely need a denser badge pass the sizing through- * `className` (tailwind-merge lets it win over the base).*/import { Trans } from '@lingui/react/macro';import { Badge } from '@/components/ui/badge';-export function PluginBetaBadge({ className }: { readonly className?: string }) {+export function PluginBetaBadge() {return (- <Badge variant="gray" className={className}>+ <Badge variant="gray"><Trans>Beta</Trans></Badge>);