From a4bcd40e7b3bf144c86937679b8fba7ddf6bf2c2 Mon Sep 17 00:00:00 2001 From: openhands Date: Thu, 15 Oct 2026 19:53:29 +0200 Subject: [PATCH] docs(catalog-sync): surface the bundle extension and the page-writing nuance MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `.hab` has been the stored bundle extension since the `FURNI_BUNDLE_EXT` switch, so the repair path already writes `.hab` (the sources serve `.nitro`), but nothing in the output said so. Print the resolved extension in the run header and correct the header comment: generating the catalog SQL also creates the `catalog_pages` sub-pages it references, so a "generate only" run is not entirely read-only — only the `catalog_items` rows wait for `--apply-sql`. --- scripts/catalog-sync.ts | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/scripts/catalog-sync.ts b/scripts/catalog-sync.ts index 501ad6a7..b616a3a1 100644 --- a/scripts/catalog-sync.ts +++ b/scripts/catalog-sync.ts @@ -29,12 +29,16 @@ // --fail-on-errors exit 3 when error-severity issues remain // // Audit is read-only by default: nothing is written until one of the repair -// flags is passed, and `--apply-sql` is the only flag that changes the catalog. +// flags is passed. One nuance: generating the catalog SQL also creates the +// `catalog_pages` category sub-pages it references (exactly like the app's own +// import does) — only the `catalog_items` rows wait for `--apply-sql`. Use +// `--organize-sql` to also emit those page INSERTs into the .sql file. import "./load-env"; import { mkdir, writeFile } from "node:fs/promises"; import { join } from "node:path"; import { pathToFileURL } from "node:url"; +import { LOCAL_BUNDLE_EXT } from "@/lib/furni/classname"; import type { AuditEvent, AuditSummary } from "@/lib/services/catalog-audit"; /** Where generated catalog SQL is written (`storage/` is gitignored). */ @@ -260,7 +264,7 @@ export async function commandRun(flags: CatalogSyncFlags): Promise { let pendingSql: string | undefined; log( - `Catalog sync — ${selected.length} source(s), ${describeActions(flags)}` + + `Catalog sync — ${selected.length} source(s), ${describeActions(flags)} — bundles stored as ${LOCAL_BUNDLE_EXT} (FURNI_BUNDLE_EXT)` + (flags.applySql ? " [SQL WILL BE APPLIED]" : ""), );