create-nextblock 0.16.3 → 0.17.0

package/templates/nextblock-template/scripts/verify-cortex-ai-global-tools.ts

@@ -1,537 +1,537 @@
-import assert from 'node:assert/strict';
-
-import {
-  executeReadCurrentCmsItem,
-  executeSearchDocumentation,
-  executeUpdateContentBlock,
-  executeUpdateCurrentCmsFields,
-  executeUpdateFooter,
-  executeUpdateNavigationBar,
-  executeUpdateSectionColumnBlock,
-} from '@nextblock-cms/cortex';
-
-type MockRow = Record<string, any>;
-
-type MockDatabase = {
-  blocks: MockRow[];
-  currencies: MockRow[];
-  languages: MockRow[];
-  navigation_items: MockRow[];
-  pages: MockRow[];
-  posts: MockRow[];
-  products: MockRow[];
-  site_settings: MockRow[];
-};
-
-class MockQuery {
-  private filters: Array<{ column: string; value: unknown }> = [];
-  private limitCount: number | null = null;
-  private operation: 'delete' | 'insert' | 'select' | 'update' | 'upsert' = 'select';
-  private payload: MockRow | MockRow[] | null = null;
-
-  constructor(
-    private readonly database: MockDatabase,
-    private readonly table: keyof MockDatabase
-  ) {}
-
-  select() {
-    return this;
-  }
-
-  eq(column: string, value: unknown) {
-    this.filters.push({ column, value });
-    return this;
-  }
-
-  limit(count: number) {
-    this.limitCount = count;
-    return this;
-  }
-
-  delete() {
-    this.operation = 'delete';
-    return this;
-  }
-
-  insert(payload: MockRow | MockRow[]) {
-    this.operation = 'insert';
-    this.payload = payload;
-    return this;
-  }
-
-  update(payload: MockRow) {
-    this.operation = 'update';
-    this.payload = payload;
-    return this;
-  }
-
-  upsert(payload: MockRow | MockRow[]) {
-    this.operation = 'upsert';
-    this.payload = payload;
-    return this;
-  }
-
-  order() {
-    return this;
-  }
-
-  maybeSingle() {
-    return this.execute().then((result) => ({
-      data: result.data?.[0] ?? null,
-      error: result.error,
-    }));
-  }
-
-  single() {
-    return this.execute().then((result) => ({
-      data: Array.isArray(result.data) ? result.data[0] : result.data,
-      error: result.error,
-    }));
-  }
-
-  then<TResult1 = any, TResult2 = never>(
-    onfulfilled?: ((value: any) => TResult1 | PromiseLike<TResult1>) | null,
-    onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null
-  ) {
-    return this.execute().then(onfulfilled, onrejected);
-  }
-
-  private matchesFilters(row: MockRow) {
-    return this.filters.every((filter) => row[filter.column] === filter.value);
-  }
-
-  private async execute() {
-    if (this.operation === 'delete') {
-      this.database[this.table] = this.database[this.table].filter(
-        (row) => !this.matchesFilters(row)
-      );
-      return { data: null, error: null };
-    }
-
-    if (this.operation === 'insert') {
-      const rows = Array.isArray(this.payload) ? this.payload : [this.payload];
-      const inserted = rows.filter(Boolean).map((row) => {
-        const nextId =
-          this.database[this.table].reduce(
-            (max, current) => Math.max(max, Number(current.id) || 0),
-            0
-          ) + 1;
-        return { id: nextId, ...row };
-      });
-      this.database[this.table].push(...inserted);
-      return { data: inserted, error: null };
-    }
-
-    if (this.operation === 'update') {
-      const payload = Array.isArray(this.payload) ? this.payload[0] : this.payload;
-      const updated: MockRow[] = [];
-
-      this.database[this.table] = this.database[this.table].map((row) => {
-        if (!this.matchesFilters(row)) {
-          return row;
-        }
-
-        const nextRow = { ...row, ...payload };
-        updated.push(nextRow);
-        return nextRow;
-      });
-
-      return { data: updated, error: null };
-    }
-
-    if (this.operation === 'upsert') {
-      const rows = Array.isArray(this.payload) ? this.payload : [this.payload];
-      rows.filter(Boolean).forEach((row) => {
-        const existingIndex = this.database[this.table].findIndex(
-          (current) => current.key && current.key === row.key
-        );
-
-        if (existingIndex >= 0) {
-          this.database[this.table][existingIndex] = {
-            ...this.database[this.table][existingIndex],
-            ...row,
-          };
-        } else {
-          this.database[this.table].push(row);
-        }
-      });
-      return { data: rows, error: null };
-    }
-
-    let data = this.database[this.table].filter((row) => this.matchesFilters(row));
-
-    if (this.limitCount !== null) {
-      data = data.slice(0, this.limitCount);
-    }
-
-    return { data, error: null };
-  }
-}
-
-function createMockSupabase(database: MockDatabase) {
-  return {
-    from: (table: string) => {
-      if (!(table in database)) {
-        throw new Error(`Unexpected mock table: ${table}`);
-      }
-
-      return new MockQuery(database, table as keyof MockDatabase);
-    },
-  };
-}
-
-async function executeConfirmed(
-  executor: (input: any, context?: any) => Promise<any>,
-  input: any,
-  context: any = {}
-) {
-  const preview = await executor(input, context);
-
-  assert.equal(preview.success, true);
-  assert.equal(preview.requiresConfirmation, true);
-  assert.equal(preview.mutationExecuted, false);
-  assert.match(preview.confirmationPhrase, /^CONFIRM .+ #[a-f0-9]{8}$/);
-
-  return executor(input, {
-    ...context,
-    latestUserMessage: preview.confirmationPhrase,
-  });
-}
-
-async function main() {
-  const database: MockDatabase = {
-    blocks: [
-      {
-        block_type: 'text',
-        content: { html_content: '<p>Old page text</p>' },
-        id: 10,
-        language_id: 1,
-        order: 0,
-        page_id: 1,
-        post_id: null,
-      },
-      {
-        block_type: 'section',
-        content: {
-          background: { type: 'none' },
-          column_blocks: [
-            [
-              {
-                block_type: 'text',
-                content: { html_content: '<p>Old nested text</p>' },
-              },
-            ],
-          ],
-          column_gap: 'md',
-          container_type: 'container',
-          padding: { bottom: 'md', top: 'md' },
-          responsive_columns: { desktop: 1, mobile: 1, tablet: 1 },
-        },
-        id: 11,
-        language_id: 1,
-        order: 1,
-        page_id: 1,
-        post_id: null,
-      },
-    ],
-    currencies: [{ code: 'USD', id: 1, is_active: true, is_default: true }],
-    languages: [
-      { code: 'en', id: 1, is_active: true, name: 'English' },
-      { code: 'fr', id: 2, is_active: true, name: 'French' },
-    ],
-    navigation_items: [
-      { id: 1, label: 'Old', language_id: 1, menu_key: 'HEADER', order: 0, url: '/old' },
-      { id: 3, label: 'Ancien', language_id: 2, menu_key: 'HEADER', order: 0, url: '/ancien' },
-      { id: 2, label: 'Old Footer', language_id: 1, menu_key: 'FOOTER', order: 0, url: '/old' },
-    ],
-    pages: [
-      {
-        id: 1,
-        meta_description: 'CMS setup, editor blocks, and Supabase auth.',
-        slug: 'docs/setup',
-        status: 'published',
-        title: 'Setup Guide',
-      },
-    ],
-    posts: [
-      {
-        excerpt: 'Use Supabase auth with profiles and roles in NextBlock.',
-        id: 1,
-        meta_description: null,
-        slug: 'supabase-auth-guide',
-        status: 'published',
-        subtitle: null,
-        title: 'Supabase Auth Guide',
-      },
-    ],
-    products: [
-      {
-        description_json: null,
-        id: 'prod_1',
-        language_id: 1,
-        meta_description: null,
-        meta_title: null,
-        short_description: 'Old short description',
-        slug: 'studio-tee',
-        status: 'draft',
-        title: 'Studio Tee',
-      },
-    ],
-    site_settings: [{ key: 'footer_copyright', value: { en: 'Old' } }],
-  };
-  const supabase = createMockSupabase(database);
-
-  const headerResult = await executeConfirmed(
-    executeUpdateNavigationBar,
-    {
-      items: [
-        { label: 'Contact', url: '/contact' },
-      ],
-      languageCode: 'en',
-      mode: 'append',
-    },
-    { revalidatePath: () => undefined, supabase }
-  );
-
-  assert.equal(headerResult.success, true);
-  assert.equal(headerResult.insertedCount, 1);
-  assert.equal(headerResult.skippedCount, 0);
-  assert.equal(
-    database.navigation_items.filter(
-      (item) => item.menu_key === 'HEADER' && item.language_id === 1
-    ).length,
-    2
-  );
-  assert.equal(
-    database.navigation_items.some((item) => item.menu_key === 'HEADER' && item.url === '/old'),
-    true
-  );
-  assert.equal(
-    database.navigation_items.some((item) => item.menu_key === 'HEADER' && item.url === '/contact'),
-    true
-  );
-
-  const duplicateHeaderResult = await executeConfirmed(
-    executeUpdateNavigationBar,
-    {
-      items: [
-        { label: 'Contact', url: '/contact' },
-      ],
-      languageCode: 'en',
-      mode: 'append',
-    },
-    { revalidatePath: () => undefined, supabase }
-  );
-
-  assert.equal(duplicateHeaderResult.success, true);
-  assert.equal(duplicateHeaderResult.insertedCount, 0);
-  assert.equal(duplicateHeaderResult.skippedCount, 1);
-
-  const frenchHeaderResult = await executeConfirmed(
-    executeUpdateNavigationBar,
-    {
-      items: [
-        { label: 'Contact', url: 'mailto:info@nextblock.dev' },
-      ],
-      languageCode: 'French',
-      mode: 'append',
-    },
-    { revalidatePath: () => undefined, supabase }
-  );
-
-  assert.equal(frenchHeaderResult.success, true);
-  assert.equal(frenchHeaderResult.languageCode, 'fr');
-  assert.equal(frenchHeaderResult.insertedCount, 1);
-  assert.equal(
-    database.navigation_items.some(
-      (item) =>
-        item.menu_key === 'HEADER' &&
-        item.language_id === 2 &&
-        item.url === 'mailto:info@nextblock.dev'
-    ),
-    true
-  );
-
-  const frenchRenameResult = await executeConfirmed(
-    executeUpdateNavigationBar,
-    {
-      items: [
-        { label: 'Nous Contacter', url: 'mailto:info@nextblock.dev' },
-      ],
-      languageCode: 'French',
-      match: { label: 'Contact' },
-      mode: 'update',
-    },
-    { revalidatePath: () => undefined, supabase }
-  );
-
-  assert.equal(frenchRenameResult.success, true);
-  assert.equal(frenchRenameResult.languageCode, 'fr');
-  assert.equal(frenchRenameResult.updatedCount, 1);
-  assert.equal(
-    database.navigation_items.some(
-      (item) =>
-        item.menu_key === 'HEADER' &&
-        item.language_id === 2 &&
-        item.label === 'Nous Contacter' &&
-        item.url === 'mailto:info@nextblock.dev'
-    ),
-    true
-  );
-  assert.equal(
-    database.navigation_items.some(
-      (item) => item.menu_key === 'HEADER' && item.language_id === 2 && item.url === '/ancien'
-    ),
-    true
-  );
-
-  await assert.rejects(
-    () =>
-      executeUpdateNavigationBar(
-        {
-          items: [
-            { label: 'Only Link', url: '/only' },
-          ],
-          languageCode: 'fr',
-          mode: 'replace',
-        },
-        { revalidatePath: () => undefined, supabase }
-      ),
-    /Refusing destructive HEADER navigation replacement/
-  );
-
-  const footerResult = await executeConfirmed(
-    executeUpdateFooter,
-    {
-      copyright: { en: '(c) {year} NextBlock. All rights reserved.' },
-      languageCode: 'en',
-      links: [{ label: 'Privacy', url: '/privacy' }],
-    },
-    { revalidatePath: () => undefined, supabase }
-  );
-
-  assert.equal(footerResult.success, true);
-  assert.equal(footerResult.footerNavigation?.insertedCount, 1);
-  assert.deepEqual(database.site_settings[0]?.value, {
-    en: '(c) {year} NextBlock. All rights reserved.',
-  });
-
-  const searchResult = await executeSearchDocumentation(
-    { limit: 2, query: 'Supabase auth' },
-    { supabase }
-  );
-
-  assert.equal(searchResult.success, true);
-  assert.equal(searchResult.results[0]?.title, 'Supabase Auth Guide');
-  assert.equal(searchResult.results[1]?.title, 'Setup Guide');
-
-  const readCurrentResult = await executeReadCurrentCmsItem(
-    { includeBlockContent: false, includeBlocks: true },
-    {
-      pageContext: { contentType: 'page', entityId: 1, slug: 'docs/setup', title: 'Setup Guide' },
-      supabase,
-    }
-  );
-
-  assert.equal(readCurrentResult.success, true);
-  assert.equal(readCurrentResult.blocks.length, 2);
-  assert.equal(readCurrentResult.blocks[0]?.blockType, 'text');
-  assert.equal(readCurrentResult.blocks[0]?.content, undefined);
-
-  const updatedBlockResult = await executeConfirmed(
-    executeUpdateContentBlock,
-    {
-      blockId: 10,
-      blockType: 'text',
-      content: { html_content: '<p>Updated page text</p>' },
-    },
-    {
-      pageContext: { contentType: 'page', entityId: 1, slug: 'docs/setup' },
-      revalidatePath: () => undefined,
-      supabase,
-    }
-  );
-
-  assert.equal(updatedBlockResult.success, true);
-  assert.deepEqual(database.blocks.find((block) => block.id === 10)?.content, {
-    html_content: '<p>Updated page text</p>',
-  });
-
-  await assert.rejects(
-    () =>
-      executeUpdateContentBlock(
-        {
-          blockId: 10,
-          blockType: 'text',
-          content: { html_content: '<p>Wrong page</p>' },
-        },
-        {
-          pageContext: { contentType: 'page', entityId: 2 },
-          supabase,
-        }
-      ),
-    /does not belong to the current page/
-  );
-
-  const nestedBlockResult = await executeConfirmed(
-    executeUpdateSectionColumnBlock,
-    {
-      blockIndex: 0,
-      blockType: 'text',
-      columnIndex: 0,
-      content: { html_content: '<p>Updated nested text</p>' },
-      parentBlockId: 11,
-    },
-    {
-      pageContext: { contentType: 'page', entityId: 1, slug: 'docs/setup' },
-      revalidatePath: () => undefined,
-      supabase,
-    }
-  );
-
-  assert.equal(nestedBlockResult.success, true);
-  assert.deepEqual(database.blocks.find((block) => block.id === 11)?.content.column_blocks[0][0].content, {
-    html_content: '<p>Updated nested text</p>',
-  });
-
-  const productDescriptionJson = {
-    content: [
-      {
-        content: [{ text: 'A Studio Tee description.', type: 'text' }],
-        type: 'paragraph',
-      },
-    ],
-    type: 'doc',
-  };
-  const productFieldResult = await executeConfirmed(
-    executeUpdateCurrentCmsFields,
-    {
-      fields: {
-        description_json: productDescriptionJson,
-        short_description: 'Soft cotton tee for Cortex AI builders.',
-        status: 'active',
-      },
-    },
-    {
-      pageContext: {
-        contentType: 'product',
-        entityId: 'prod_1',
-        slug: 'studio-tee',
-        title: 'Studio Tee',
-      },
-      revalidatePath: () => undefined,
-      supabase,
-    }
-  );
-
-  assert.equal(productFieldResult.success, true);
-  assert.equal(database.products[0].status, 'active');
-  assert.deepEqual(database.products[0].description_json, productDescriptionJson);
-
-  console.log('Cortex AI global tool verifier passed.');
-}
-
-main().catch((error) => {
-  console.error(error);
-  process.exit(1);
-});
+import assert from 'node:assert/strict';
+
+import {
+  executeReadCurrentCmsItem,
+  executeSearchDocumentation,
+  executeUpdateContentBlock,
+  executeUpdateCurrentCmsFields,
+  executeUpdateFooter,
+  executeUpdateNavigationBar,
+  executeUpdateSectionColumnBlock,
+} from '@nextblock-cms/cortex';
+
+type MockRow = Record<string, any>;
+
+type MockDatabase = {
+  blocks: MockRow[];
+  currencies: MockRow[];
+  languages: MockRow[];
+  navigation_items: MockRow[];
+  pages: MockRow[];
+  posts: MockRow[];
+  products: MockRow[];
+  site_settings: MockRow[];
+};
+
+class MockQuery {
+  private filters: Array<{ column: string; value: unknown }> = [];
+  private limitCount: number | null = null;
+  private operation: 'delete' | 'insert' | 'select' | 'update' | 'upsert' = 'select';
+  private payload: MockRow | MockRow[] | null = null;
+
+  constructor(
+    private readonly database: MockDatabase,
+    private readonly table: keyof MockDatabase
+  ) {}
+
+  select() {
+    return this;
+  }
+
+  eq(column: string, value: unknown) {
+    this.filters.push({ column, value });
+    return this;
+  }
+
+  limit(count: number) {
+    this.limitCount = count;
+    return this;
+  }
+
+  delete() {
+    this.operation = 'delete';
+    return this;
+  }
+
+  insert(payload: MockRow | MockRow[]) {
+    this.operation = 'insert';
+    this.payload = payload;
+    return this;
+  }
+
+  update(payload: MockRow) {
+    this.operation = 'update';
+    this.payload = payload;
+    return this;
+  }
+
+  upsert(payload: MockRow | MockRow[]) {
+    this.operation = 'upsert';
+    this.payload = payload;
+    return this;
+  }
+
+  order() {
+    return this;
+  }
+
+  maybeSingle() {
+    return this.execute().then((result) => ({
+      data: result.data?.[0] ?? null,
+      error: result.error,
+    }));
+  }
+
+  single() {
+    return this.execute().then((result) => ({
+      data: Array.isArray(result.data) ? result.data[0] : result.data,
+      error: result.error,
+    }));
+  }
+
+  then<TResult1 = any, TResult2 = never>(
+    onfulfilled?: ((value: any) => TResult1 | PromiseLike<TResult1>) | null,
+    onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null
+  ) {
+    return this.execute().then(onfulfilled, onrejected);
+  }
+
+  private matchesFilters(row: MockRow) {
+    return this.filters.every((filter) => row[filter.column] === filter.value);
+  }
+
+  private async execute() {
+    if (this.operation === 'delete') {
+      this.database[this.table] = this.database[this.table].filter(
+        (row) => !this.matchesFilters(row)
+      );
+      return { data: null, error: null };
+    }
+
+    if (this.operation === 'insert') {
+      const rows = Array.isArray(this.payload) ? this.payload : [this.payload];
+      const inserted = rows.filter(Boolean).map((row) => {
+        const nextId =
+          this.database[this.table].reduce(
+            (max, current) => Math.max(max, Number(current.id) || 0),
+            0
+          ) + 1;
+        return { id: nextId, ...row };
+      });
+      this.database[this.table].push(...inserted);
+      return { data: inserted, error: null };
+    }
+
+    if (this.operation === 'update') {
+      const payload = Array.isArray(this.payload) ? this.payload[0] : this.payload;
+      const updated: MockRow[] = [];
+
+      this.database[this.table] = this.database[this.table].map((row) => {
+        if (!this.matchesFilters(row)) {
+          return row;
+        }
+
+        const nextRow = { ...row, ...payload };
+        updated.push(nextRow);
+        return nextRow;
+      });
+
+      return { data: updated, error: null };
+    }
+
+    if (this.operation === 'upsert') {
+      const rows = Array.isArray(this.payload) ? this.payload : [this.payload];
+      rows.filter(Boolean).forEach((row) => {
+        const existingIndex = this.database[this.table].findIndex(
+          (current) => current.key && current.key === row.key
+        );
+
+        if (existingIndex >= 0) {
+          this.database[this.table][existingIndex] = {
+            ...this.database[this.table][existingIndex],
+            ...row,
+          };
+        } else {
+          this.database[this.table].push(row);
+        }
+      });
+      return { data: rows, error: null };
+    }
+
+    let data = this.database[this.table].filter((row) => this.matchesFilters(row));
+
+    if (this.limitCount !== null) {
+      data = data.slice(0, this.limitCount);
+    }
+
+    return { data, error: null };
+  }
+}
+
+function createMockSupabase(database: MockDatabase) {
+  return {
+    from: (table: string) => {
+      if (!(table in database)) {
+        throw new Error(`Unexpected mock table: ${table}`);
+      }
+
+      return new MockQuery(database, table as keyof MockDatabase);
+    },
+  };
+}
+
+async function executeConfirmed(
+  executor: (input: any, context?: any) => Promise<any>,
+  input: any,
+  context: any = {}
+) {
+  const preview = await executor(input, context);
+
+  assert.equal(preview.success, true);
+  assert.equal(preview.requiresConfirmation, true);
+  assert.equal(preview.mutationExecuted, false);
+  assert.match(preview.confirmationPhrase, /^CONFIRM .+ #[a-f0-9]{8}$/);
+
+  return executor(input, {
+    ...context,
+    latestUserMessage: preview.confirmationPhrase,
+  });
+}
+
+async function main() {
+  const database: MockDatabase = {
+    blocks: [
+      {
+        block_type: 'text',
+        content: { html_content: '<p>Old page text</p>' },
+        id: 10,
+        language_id: 1,
+        order: 0,
+        page_id: 1,
+        post_id: null,
+      },
+      {
+        block_type: 'section',
+        content: {
+          background: { type: 'none' },
+          column_blocks: [
+            [
+              {
+                block_type: 'text',
+                content: { html_content: '<p>Old nested text</p>' },
+              },
+            ],
+          ],
+          column_gap: 'md',
+          container_type: 'container',
+          padding: { bottom: 'md', top: 'md' },
+          responsive_columns: { desktop: 1, mobile: 1, tablet: 1 },
+        },
+        id: 11,
+        language_id: 1,
+        order: 1,
+        page_id: 1,
+        post_id: null,
+      },
+    ],
+    currencies: [{ code: 'USD', id: 1, is_active: true, is_default: true }],
+    languages: [
+      { code: 'en', id: 1, is_active: true, name: 'English' },
+      { code: 'fr', id: 2, is_active: true, name: 'French' },
+    ],
+    navigation_items: [
+      { id: 1, label: 'Old', language_id: 1, menu_key: 'HEADER', order: 0, url: '/old' },
+      { id: 3, label: 'Ancien', language_id: 2, menu_key: 'HEADER', order: 0, url: '/ancien' },
+      { id: 2, label: 'Old Footer', language_id: 1, menu_key: 'FOOTER', order: 0, url: '/old' },
+    ],
+    pages: [
+      {
+        id: 1,
+        meta_description: 'CMS setup, editor blocks, and Supabase auth.',
+        slug: 'docs/setup',
+        status: 'published',
+        title: 'Setup Guide',
+      },
+    ],
+    posts: [
+      {
+        excerpt: 'Use Supabase auth with profiles and roles in NextBlock.',
+        id: 1,
+        meta_description: null,
+        slug: 'supabase-auth-guide',
+        status: 'published',
+        subtitle: null,
+        title: 'Supabase Auth Guide',
+      },
+    ],
+    products: [
+      {
+        description_json: null,
+        id: 'prod_1',
+        language_id: 1,
+        meta_description: null,
+        meta_title: null,
+        short_description: 'Old short description',
+        slug: 'studio-tee',
+        status: 'draft',
+        title: 'Studio Tee',
+      },
+    ],
+    site_settings: [{ key: 'footer_copyright', value: { en: 'Old' } }],
+  };
+  const supabase = createMockSupabase(database);
+
+  const headerResult = await executeConfirmed(
+    executeUpdateNavigationBar,
+    {
+      items: [
+        { label: 'Contact', url: '/contact' },
+      ],
+      languageCode: 'en',
+      mode: 'append',
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(headerResult.success, true);
+  assert.equal(headerResult.insertedCount, 1);
+  assert.equal(headerResult.skippedCount, 0);
+  assert.equal(
+    database.navigation_items.filter(
+      (item) => item.menu_key === 'HEADER' && item.language_id === 1
+    ).length,
+    2
+  );
+  assert.equal(
+    database.navigation_items.some((item) => item.menu_key === 'HEADER' && item.url === '/old'),
+    true
+  );
+  assert.equal(
+    database.navigation_items.some((item) => item.menu_key === 'HEADER' && item.url === '/contact'),
+    true
+  );
+
+  const duplicateHeaderResult = await executeConfirmed(
+    executeUpdateNavigationBar,
+    {
+      items: [
+        { label: 'Contact', url: '/contact' },
+      ],
+      languageCode: 'en',
+      mode: 'append',
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(duplicateHeaderResult.success, true);
+  assert.equal(duplicateHeaderResult.insertedCount, 0);
+  assert.equal(duplicateHeaderResult.skippedCount, 1);
+
+  const frenchHeaderResult = await executeConfirmed(
+    executeUpdateNavigationBar,
+    {
+      items: [
+        { label: 'Contact', url: 'mailto:info@nextblock.dev' },
+      ],
+      languageCode: 'French',
+      mode: 'append',
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(frenchHeaderResult.success, true);
+  assert.equal(frenchHeaderResult.languageCode, 'fr');
+  assert.equal(frenchHeaderResult.insertedCount, 1);
+  assert.equal(
+    database.navigation_items.some(
+      (item) =>
+        item.menu_key === 'HEADER' &&
+        item.language_id === 2 &&
+        item.url === 'mailto:info@nextblock.dev'
+    ),
+    true
+  );
+
+  const frenchRenameResult = await executeConfirmed(
+    executeUpdateNavigationBar,
+    {
+      items: [
+        { label: 'Nous Contacter', url: 'mailto:info@nextblock.dev' },
+      ],
+      languageCode: 'French',
+      match: { label: 'Contact' },
+      mode: 'update',
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(frenchRenameResult.success, true);
+  assert.equal(frenchRenameResult.languageCode, 'fr');
+  assert.equal(frenchRenameResult.updatedCount, 1);
+  assert.equal(
+    database.navigation_items.some(
+      (item) =>
+        item.menu_key === 'HEADER' &&
+        item.language_id === 2 &&
+        item.label === 'Nous Contacter' &&
+        item.url === 'mailto:info@nextblock.dev'
+    ),
+    true
+  );
+  assert.equal(
+    database.navigation_items.some(
+      (item) => item.menu_key === 'HEADER' && item.language_id === 2 && item.url === '/ancien'
+    ),
+    true
+  );
+
+  await assert.rejects(
+    () =>
+      executeUpdateNavigationBar(
+        {
+          items: [
+            { label: 'Only Link', url: '/only' },
+          ],
+          languageCode: 'fr',
+          mode: 'replace',
+        },
+        { revalidatePath: () => undefined, supabase }
+      ),
+    /Refusing destructive HEADER navigation replacement/
+  );
+
+  const footerResult = await executeConfirmed(
+    executeUpdateFooter,
+    {
+      copyright: { en: '(c) {year} NextBlock. All rights reserved.' },
+      languageCode: 'en',
+      links: [{ label: 'Privacy', url: '/privacy' }],
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(footerResult.success, true);
+  assert.equal(footerResult.footerNavigation?.insertedCount, 1);
+  assert.deepEqual(database.site_settings[0]?.value, {
+    en: '(c) {year} NextBlock. All rights reserved.',
+  });
+
+  const searchResult = await executeSearchDocumentation(
+    { limit: 2, query: 'Supabase auth' },
+    { supabase }
+  );
+
+  assert.equal(searchResult.success, true);
+  assert.equal(searchResult.results[0]?.title, 'Supabase Auth Guide');
+  assert.equal(searchResult.results[1]?.title, 'Setup Guide');
+
+  const readCurrentResult = await executeReadCurrentCmsItem(
+    { includeBlockContent: false, includeBlocks: true },
+    {
+      pageContext: { contentType: 'page', entityId: 1, slug: 'docs/setup', title: 'Setup Guide' },
+      supabase,
+    }
+  );
+
+  assert.equal(readCurrentResult.success, true);
+  assert.equal(readCurrentResult.blocks.length, 2);
+  assert.equal(readCurrentResult.blocks[0]?.blockType, 'text');
+  assert.equal(readCurrentResult.blocks[0]?.content, undefined);
+
+  const updatedBlockResult = await executeConfirmed(
+    executeUpdateContentBlock,
+    {
+      blockId: 10,
+      blockType: 'text',
+      content: { html_content: '<p>Updated page text</p>' },
+    },
+    {
+      pageContext: { contentType: 'page', entityId: 1, slug: 'docs/setup' },
+      revalidatePath: () => undefined,
+      supabase,
+    }
+  );
+
+  assert.equal(updatedBlockResult.success, true);
+  assert.deepEqual(database.blocks.find((block) => block.id === 10)?.content, {
+    html_content: '<p>Updated page text</p>',
+  });
+
+  await assert.rejects(
+    () =>
+      executeUpdateContentBlock(
+        {
+          blockId: 10,
+          blockType: 'text',
+          content: { html_content: '<p>Wrong page</p>' },
+        },
+        {
+          pageContext: { contentType: 'page', entityId: 2 },
+          supabase,
+        }
+      ),
+    /does not belong to the current page/
+  );
+
+  const nestedBlockResult = await executeConfirmed(
+    executeUpdateSectionColumnBlock,
+    {
+      blockIndex: 0,
+      blockType: 'text',
+      columnIndex: 0,
+      content: { html_content: '<p>Updated nested text</p>' },
+      parentBlockId: 11,
+    },
+    {
+      pageContext: { contentType: 'page', entityId: 1, slug: 'docs/setup' },
+      revalidatePath: () => undefined,
+      supabase,
+    }
+  );
+
+  assert.equal(nestedBlockResult.success, true);
+  assert.deepEqual(database.blocks.find((block) => block.id === 11)?.content.column_blocks[0][0].content, {
+    html_content: '<p>Updated nested text</p>',
+  });
+
+  const productDescriptionJson = {
+    content: [
+      {
+        content: [{ text: 'A Studio Tee description.', type: 'text' }],
+        type: 'paragraph',
+      },
+    ],
+    type: 'doc',
+  };
+  const productFieldResult = await executeConfirmed(
+    executeUpdateCurrentCmsFields,
+    {
+      fields: {
+        description_json: productDescriptionJson,
+        short_description: 'Soft cotton tee for Cortex AI builders.',
+        status: 'active',
+      },
+    },
+    {
+      pageContext: {
+        contentType: 'product',
+        entityId: 'prod_1',
+        slug: 'studio-tee',
+        title: 'Studio Tee',
+      },
+      revalidatePath: () => undefined,
+      supabase,
+    }
+  );
+
+  assert.equal(productFieldResult.success, true);
+  assert.equal(database.products[0].status, 'active');
+  assert.deepEqual(database.products[0].description_json, productDescriptionJson);
+
+  console.log('Cortex AI global tool verifier passed.');
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});