From 17e3b7eadbdacd3777c44f1c08a426f1cd9c28a0 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 29 Sep 2026 15:44:42 +0000 Subject: [PATCH] fix(spec): the ui-html-page-div-refused entry states when dev and start compile The why text said `dev` and `start` run `objectstack compile` first. They run it before they boot only when the artifact is missing or `--compile` is passed (dev.ts `needsCompile`, start.ts `shouldAutoCompile`), and `dev`'s watch mode runs it when a watched file changes. Entry reworded, registry regenerated with gen:migration-registry, patch changeset added. Claude-Session: https://claude.ai/code/session_01Sfe5YjBLwB9J3y8fvm2xq1 Co-authored-by: Claude --- .changeset/20649-div-entry-compile-condition.md | 13 +++++++++++++ .../entries/semantic/18.ui-html-page-div-refused.ts | 4 +++- packages/spec/src/migrations/registry.ts | 4 +++- 3 files changed, 19 insertions(+), 2 deletions(-) create mode 100644 .changeset/20649-div-entry-compile-condition.md diff --git a/.changeset/20649-div-entry-compile-condition.md b/.changeset/20649-div-entry-compile-condition.md new file mode 100644 index 00000000000..9e4e174bd32 --- /dev/null +++ b/.changeset/20649-div-entry-compile-condition.md @@ -0,0 +1,13 @@ +--- +'@objectstack/spec': patch +--- + +fix(spec): the `ui-html-page-div-refused` migration entry states when `dev` and `start` compile (#20649) + +Clause-②: no + +The entry's `reason`, which `objectstack migrate meta` prints as its `why:` +line, said `dev` and `start` run `objectstack compile` first. They run it before +they boot only when the artifact is missing or `--compile` is passed, and `dev`'s +watch mode runs it when a watched file changes. The text now says so. No schema +accepts or refuses anything it did not before. diff --git a/packages/spec/src/migrations/entries/semantic/18.ui-html-page-div-refused.ts b/packages/spec/src/migrations/entries/semantic/18.ui-html-page-div-refused.ts index 63f8b8df74a..0fbab496b84 100644 --- a/packages/spec/src/migrations/entries/semantic/18.ui-html-page-div-refused.ts +++ b/packages/spec/src/migrations/entries/semantic/18.ui-html-page-div-refused.ts @@ -31,7 +31,9 @@ export const entry: SemanticMigration = { 'An html page\'s source is a JSX string, not a keyed document: `objectstack migrate meta` ' + 'rewrites stored metadata by key and cannot rewrite a tag inside authored source, so the ' + 'move is by hand, and which wrapper keeps a page\'s layout is the author\'s call. ' - + '`objectstack validate`, `objectstack compile` (which `dev` and `start` run first) and ' + + '`objectstack validate`, `objectstack compile` (which `dev` and `start` run before they ' + + 'boot only when the artifact is missing or `--compile` is passed, and `dev`\'s watch mode ' + + 'when a watched file changes) and ' + '`objectstack lint` check that source against an SDUI component manifest: the ' + '`sdui.manifest.json` in the directory the command runs in, then the copy ' + '`@objectstack/console` ships. The second lookup asked for a file the console package ' diff --git a/packages/spec/src/migrations/registry.ts b/packages/spec/src/migrations/registry.ts index fda8905b1ec..87094eabaf6 100644 --- a/packages/spec/src/migrations/registry.ts +++ b/packages/spec/src/migrations/registry.ts @@ -17453,7 +17453,9 @@ const step18: MigrationStep = { 'An html page\'s source is a JSX string, not a keyed document: `objectstack migrate meta` ' + 'rewrites stored metadata by key and cannot rewrite a tag inside authored source, so the ' + 'move is by hand, and which wrapper keeps a page\'s layout is the author\'s call. ' - + '`objectstack validate`, `objectstack compile` (which `dev` and `start` run first) and ' + + '`objectstack validate`, `objectstack compile` (which `dev` and `start` run before they ' + + 'boot only when the artifact is missing or `--compile` is passed, and `dev`\'s watch mode ' + + 'when a watched file changes) and ' + '`objectstack lint` check that source against an SDUI component manifest: the ' + '`sdui.manifest.json` in the directory the command runs in, then the copy ' + '`@objectstack/console` ships. The second lookup asked for a file the console package '